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Android 是 谷歌 (Google) 发 布 的 一 个 开放 源 代码 的 手机 平台 ， 
由 Linux 内 核 、 中 间 件 、 应 用 程序 框架 和 应 用 软件 组 成 ,是 第 一 个 可 
以 完全 定制 ,免费 、 开 放 的 手机 平台 。Android 不 仅 能 够 在 智能 手机 
中 使 用 ,还 可 以 用 在 平板 电脑 .移动 互联 网 终端 上 网 笔记 本 、 便 扒 
式 媒体 播放 器 和 电视 等 电子 设备 上 。 

Android 在 诞生 之 日 起 便 受 到 广泛 的 关注 ,目前 以 76.6% 的 市 
场 份额 在 智能 手机 市 场 中 排名 第 一 。 随 着 Android 5.0 版 本 的 公 
布 ,Android 系统 迎 来 了 全 新 的 视觉 时 代 , 在 虚拟 世界 中 模拟 出 物理 
世界 中 纸张 材质 的 感觉 ,使 所 有 的 应 用 程序 具有 统一 的 视觉 设计 、 
视觉 反馈 和 操作 反馈 。 

本 书 基于 Android 5. 0 版 本 ,全 面 而 又 详细 地 介绍 了 Android 
应 用 程序 开发 所 涉及 的 各 个 方面 内 容 , 包 括 集成 开发 环境 搭建 、 用 
户 界面 设计 、 后 台 服 务 开发 、 数 据 存 储 、 组 件 通 信 、 地 图 应 用 、Widget 
和 Android МОК 等 内 容 。 系 统 地 介绍 了 Android 的 各 种 特性 ,将 
Android 系统 的 优越 之 处 展现 在 读者 面前 ,通过 每 章 的 内 容 逐 渐 引 
领 读者 进入 Android 的 世界 。 

第 1 章 介绍 Android 平台 的 起 源 、 发 展 . 特 征 和 体系 结构 ,并 对 
主流 的 手机 操作 系统 进行 简单 的 介绍 。 

第 2 章 详细 说 明 Android 开发 环境 的 安装 与 配置 方法 ,并 对 部 
分 开发 和 调试 工具 进行 简单 的 介绍 。 

第 3 章 介 绍 基于 Eclipse 和 Android Studio 开发 Android 应 用 
程序 的 基础 知识 和 基本 方法 ,详细 说 明 Android 工程 文件 的 结构 和 
用 途 , 并 介绍 使 用 命令 行 开发 、 安 装 和 运行 Android 应 用 程序 的 
3X. 

第 4 章 介绍 Android 程序 的 生命 周期 和 进程 优先 级 的 变更 方 
式 , 并 以 Activity 为 例 说 明 Android 组 件 生命 周期 的 状态 转换 和 事 
件 回调 函数 的 调用 顺序 ,最 后 简单 介绍 Android 调试 工具 的 使 用 
方法 。 

第 5 章 介 绍 Android 用 户 界面 的 开发 方法 ,重点 介绍 常见 的 界 
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面 控 件 、 界 面 布局 、 操 作 栏 `Fragment、 菜 单 和 界面 事件 的 使 用 方法 。 

第 6 章 介绍 Android 系统 的 组 件 通信 机 制 , 其 中 包括 使 用 Intent 启动 组 件 的 原理 和 
方法 ,Intent 过 滤器 的 原理 与 匹配 机 制 ,以 及 广播 消息 的 接收 和 发 送 方法 等 。 

第 7 章 介 绍 Android 系统 的 后 台 服 务 组 件 Service, 内容 包括 Service 的 原理 和 用 途 ， 
Service 的 启动 和 绑 定 ,AIDL 语言 定义 跨 进 程 服务 的 接口 ,以 及 线程 使 用 和 跨 线 程 界面 
更 新 。 

第 8 章 介绍 Android 系统 所 提供 的 多 种 数据 存储 方法 ,其 中 包括 易于 使 用 的 
SharedPreferences、 经 典 的 文件 存储 和 轻 量 级 的 SQLite 数据 库 , 最 后 介绍 Android 系统 
应 用 程序 间 的 数据 共享 接口 ContentProvider。 

第 9 章 介 绍 位 置 服务 的 概念 和 位 置信 息 获 取 方 法 ,简单 说 明 Google 地 图 密 钥 的 申 
请 方法 ,重点 介绍 Google 地 图 中 的 MapView,MapController 和 Overlay 的 使 用 方法 。 

第 10 章 介绍 Widget 的 开发 方法 ,详细 讲解 Widget 的 设计 原则 和 开发 步骤 ,说 明 
Widget 的 配置 方法 ,以 及 使 用 Service 更 新 Widget 的 技巧 。 

第 11 章 介绍 Android 系统 中 使 用 C/C ++ 本 地 代码 进行 程序 开发 的 方法 ,并 说 明 
Android NDK 的 用 途 和 优 缺点 ,本 地 代码 的 开发 和 编译 环境 ,以 及 与 CPU 指令 集 相 关 的 
开发 示例 。 

第 12 章 以 “天 气 预报 软件 ?为 例 , 介 绍 Android 应 用 程序 开发 过 程 中 需求 分 析 、 界 面 
设计 、 模 块 设计 和 程序 开发 等 步骤 ,并 简单 介绍 Android 应 用 程序 的 设计 和 开发 的 思路 
与 方法 。 

本 书 主要 由 哈尔滨 工程 大 学 王 向 辉 和 张 国 印 .哈尔滨 商业 大 学 的 沈 洁 负责 编写 。 
中 , 王 向 辉 编 写 第 1— 4 章 , 张 国 印 编写 第 5 一 6 章 , 沈 洁 编写 第 7 一 12 章 。 同 时 参与 本 书 
编写 工作 的 还 有 刘 启 超 、 王 玲 、 岔 岩 青 、 杜 婧 、 徐 子 涵 、 分 新 、 马 书 亮 、 张 灿 涯 、 张 弘 、 王 建 
立 、 李 慧 婷 、 周 维 、 郭 轶 、 赵 乙 东 、 张 洪 浩 、 李 展 星 ,这 里 对 他 们 的 辛苦 工作 表示 襄 心 的 

Android 是 一 个 发 展 迅 速 的 手机 平台 ,很 多 方面 还 在 不 断 完善 和 变化 。 由 于 能 力 和 
KFAR BARRAN ,但 仍然 难免 存在 错误 和 足 漏 的 地 方 ,希望 各 位 专家 、 教 师 和 学 
生 能 毫 不 保留 地 提出 所 发 现 的 问题 ,与 编者 共同 讨论 ,编者 的 邮箱 为 wangxianghui@ 
live. cn。 本 书 的 示例 代码 和 电子 课件 可 以 在 http://android. hrbeu. edu. cn 处 下 载 。 
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Android 简介 


Android 是 一 个 优秀 的 开源 手机 平台 ,通过 本 章 的 学 习 可 以 让 读者 对 Android 平台 
的 起 源 发展. 特征 和 体系 结构 有 个 初步 的 了 解 ,并 通过 介绍 Windows Phone 8.105, 
Linux 和 黑 侮 等 主流 的 手机 操作 系统 ,充分 理解 Android 平台 的 优势 和 不 足 。 

本 章 学 习 目 标 

。 了 解 各 种 手机 操作 系统 的 特点 

° 了 解 开 放手 机 联盟 的 目的 .性质 和 组 成 ; 

° 了 解 Android 平台 的 发 展 历史 ; 

。 掌握 Android 平台 的 特征 ; 

。 掌握 Android 平台 的 体系 结构 。 


11 手机 操作 系统 


在 早期 的 手机 内 部 是 没有 智能 操作 系统 的 ,所 有 的 软件 都 是 由 手机 生产 商 在 设计 时 
定制 的 ,因此 手机 在 设计 完成 后 基本 是 没有 扩展 功能 的 。 后 期 的 手机 为 了 提高 手机 的 可 
扩展 性 ,使 用 了 专 为 移动 设备 开发 的 操作 系统 ,使 用 者 可 以 根据 需要 安装 不 同类 型 的 软 
件 。 虽 然 使 用 操作 系统 的 手机 具有 更 好 的 可 扩展 性 ,但 由 于 操作 系统 对 于 手机 的 硬件 配 
置 要 求 较 高 ,所 产生 的 硬件 成 本 和 操作 系统 成 本 使 手机 的 售 价 明显 高 于 不 使 用 操作 系统 
的 手机 ,因此 一 般 只 有 在 高 端 智能 手机 上 使 用 手机 操作 系统 。 

目前 ,手机 上 的 操作 系统 主要 包括 以 下 几 种 ,分别 是 Android, iOS, Windows Phone 
8 USE RII Linux, 


1. Android 


Android 是 谷歌 (Google) 公 司 发 布 的 基于 Linux 的 开源 手机 平台 ,该 平台 由 操作 系 
统 .中间 件 和 应 用 软件 组 成 ,是 第 一 个 可 以 完全 定制 .免费 .开放 的 手机 平台 。Android 是 
一 个 完全 免费 的 手机 平台 ,使 用 Android 并 不 需要 授权 费 ,而 且 因 为 Android 平台 有 丰 
富 的 应 用 程序 ,也 大 幅度 降低 了 应 用 程序 的 开发 费用 ,可 以 节约 15% — 20 V5 RI FOL е 
成 本 。Android 底层 使 用 开源 的 Linux 操作 系统 ,同时 开放 了 应 用 程序 开发 工具 ,使 所 有 
程序 开发 人 员 都 在 统一 .开放 的 开发 平台 上 进行 开发 ,保证 了 Android 应 用 程序 的 可 移 
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植 性 。Android 平台 使 用 Java 语言 进行 开发 ,支持 SQLite 数据 库 .2D/3D 图 形 加 速 、 多 
媒体 播放 和 摄像 头等 硬件 设备 ,并 内 置 了 丰富 的 应 用 程序 ,如 电子 邮件 客户 端 \ 闹 钟 、 
Web 浏览 器 ,计时 器 通讯 录 和 MP3 播放 器 等 。Android 界面 如 图 1.1 所 示 。 


1.1 Android 界面 


2. iOS 


iOS 是 由 蕴 果 公司 开发 的 操作 系统 ,以 开放 源 代码 的 操作 系统 Darwin 为 基础 ,主要 

供 蔷 果 公 司 生产 的 iPhone iPod touch,iPad 以 及 Apple TV 使 用 。iOS 的 系统 架构 分 为 
4 个 层次 ,分 别 是 核心 操作 系统 层 、 核 心服 务 层 ,媒体 层 和 可 轻 触 层 。 为 了 便于 iPhone 应 

用 程序 开发 ,苹果 公司 提供 了 iPhone SDK ,为 iOS 应 用 程序 的 开发 .测试 .运行 和 调试 提 
供 工具 。 多 点 触摸 操作 是 IOS 的 用 户 界 面 基础 ,也 是 iOS 区 别 于 其 他 手机 操作 系统 的 特 
性 之 一 。 此 外 ,iOS 还 通过 支持 内 置 加 速 器 ,允许 系统 界面 根据 屏幕 的 方向 而 改变 方向 。 
iOS 自 带 大 量 的 应 用 程序 ,包括 SMS 简讯 日历. 照片. 相机、 YouTube、 股 市 .地 图 .天气 
时 间 、 计 算 机 、 备 忘 录 、 系 统 设 定 iTunes 和 通讯 录 等 。 

iOS 界面 如 图 1.2 所 示 。 


3. Windows Phone 8 


Windows Phone 8 是 微软 2012 年 6 月 发 布 的 一 款 Windows Phone(WP) 手 机 操作 
系统 , 它 采 用 和 Windows 8 相同 的 针对 移动 平台 精简 优化 NT 内 核 . 并 且 内 置 诺基亚 地 
图 。 这 标志 着 移动 版 WP 将 提前 与 Windows 系统 同步 ,部 分 Windows 8 应 用 可 以 更 方 
便 地 移植 到 手机 上 。 同 时 它 也 是 第 一 个 支持 双核 CPU 的 WP 版 本 ,这 让 搭载 Windows 
Phone 8 的 设备 可 以 获得 更 好 的 运行 效果 ,并 且 它 还 支持 更 多 的 屏幕 分 辨 率 选择 ,包括 
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WVGA, WXGA ЯП 720p. Windows Phone 8 的 用 户 界 面 提 供 了 动态 .个 性 化 的 界面 风 
格 ,手机 屏幕 上 那些 彩色 的 磁 贴 不 仅仅 是 各 种 应 用 的 快捷 入 口 , 对 于 一 些 含 有 实时 更 新 
信息 的 应 用 ,动态 磁 贴 也 可 以 自动 显示 实时 信息 。 它 的 用 户 界面 如 图 1. 3 所 示 。2014 年 
4 月 微软 正式 宣布 Windows Phone 8. 1 预览 版 推送 , 它 针对 Windows Phone 8 大 量 的 系 
统 体验 进行 了 改进 ,包括 新 的 个 人 数字 助理 Cortana、 通 知 中 心 、 快 捷 设置 .音量 分 离 .新 
的 日 历 IE11 等 。 
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1.2 iOS 界面 图 1.3 Windows Phone 8 界面 


4. 黑莓 系统 


黑 芍 系统 是 加 拿 大 КІМ 公司 推出 的 一 种 移动 操作 系统 ,主要 在 黑莓 手机 上 使 用 ,其 
峙 色 是 支持 电子 邮件 推送 功能 ,邮件 服务 器 主动 将 收 到 的 邮件 推送 到 用 户 的 手持 设备 
上 ,而 不 需要 用 户 频繁 地 连接 网 络 查看 是 否 有 新 邮件 。 同 时 ,黑莓 系统 提供 手提 电话 、 文 
字 短 信 、 互 联网 传真 .网 页 浏览 及 其 他 无 线 信息 服务 功能 。 黑 莓 系统 主要 针对 商务 应 用 ， 
具有 很 高 的 安全 性 和 可 靠 性 。 黑 莓 系统 界面 如 图 1.4 所 示 。 


5. Linux 手机 操作 系统 


Linux 手机 操作 系统 是 由 计算 机 Linux 操作 系统 演变 而 来 的 。Linux 进入 到 移动 终 
端 操作 系统 以 来 ,就 以 其 开放 源 代码 的 优势 吸引 了 越 来 越 多 的 终端 厂商 和 运营 商 的 关 
注 。 因 为 Linux 开放 源 代码 的 特性 ,能 够 大 幅度 降低 手机 的 软件 成 本 ,而 且 有 利于 独立 
软件 开发 商 开 发 出 硬件 利用 效率 高 .功能 更 强大 的 应 用 软件 ,也 便于 行业 用 户 开发 安全 、 
可 靠 的 应 用 系统 。 同 时 也 满足 了 手机 制造 商 根据 实际 情况 有 针对 性 地 开发 Linux 手机 
操作 系统 的 要 求 , 又 吸引 了 众多 软件 开发 商 对 内 容 应 用 软件 的 开发 ,丰富 了 第 三 方 应 用 。 


^h. 
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然而 ,Linux 操作 系统 有 其 先天 的 不 足 。 首 先 ,入 门 难 度 高 .熟悉 其 开发 环境 的 工程 师 少 、 
集成 开发 环境 较 差 ;其 次 ,由 于 微软 操作 系统 源 代码 的 不 公开 ,基于 Linux 的 产品 与 个 人 
计算 机 的 连接 性 较 差 ;最 后 ,尽管 目前 从 事 Linux 操作 系统 开发 的 公司 数量 较 多 ,但 真正 
具有 很 强 开发 实力 的 公司 却 很 少 ,而 且 这 些 公司 之 间 相 互 独 立地 进行 开发 ,很 难 实现 更 
大 的 技术 突破 。Linux 手机 操作 系统 界面 如 图 1. 5 Bran. 


图 1.4 黑莓 系统 界面 图 1.5 Linux 手机 操作 系统 界面 


12 Android 起 源 


说 到 Android 的 发 展 史 ,首先 要 介绍 一 下 Android 平台 的 推动 者 OH A (Open 
Handset Alliance, 开 放手 机 联盟 ), 然 后 按照 时 间 顺 序 介 绍 Android 的 重要 事件 ,包括 
Android SDK 的 版 本 发 布 .Google JF £ 3$ X 3€ , Android 手机 和 平板 电脑 发 布 等 内 容 。 
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ОНА 是 美国 谷歌 公司 于 2007 年 发 起 的 一 个 全 球 性 的 联盟 组 织 ,目标 是 研发 用 于 移 
动 设备 的 新 技术 ,用 以 大 幅 削 减 移动 设备 开发 与 推广 成 本 。 同 时 通过 联盟 各 个 合作 方 的 
努力 ,建立 移动 通信 和 领域 新 的 协作 环境 ,促进 创新 移动 设备 的 开发 ,使 消费 者 的 用 户 体 验 
不 断 改善 。 

ОНА 成 立时 由 34 个 成 员 组 织 构成 ,包括 电信 运营 商 . 半 导体 芯片 商 . 手 机 硬件 制造 
商 、 软 件 厂 商 和 商品 化 公司 五 类 ,涵盖 移动 终端 产业 链 各 个 环节 。 目 前 ,OHA 的 成 员 组 
织 数目 已 经 增加 到 82 个 。 谷 歌 通过 与 运营 商 、 设 备 制 造 商 .开发 商 和 其 他 有 关 各 方 结 
深层 次 的 合作 伙伴 关系 ,借助 建立 标准 化 .开放 式 的 移动 软件 平台 ,在 移动 产业 内 形成 
个 开放 式 的 生态 系统 。 

ТЕ ОНА 的 组 织 成 员 中 ,电信 运营 商 主 要 有 中 国 移动 通信 .KDDI( 日 本 ) МТТ 
DoCoMo( H Æ) .Sprint Nextel (3$ E) , T-Mobile (3$ ER) , Telecom (KAD .中 国联 通 、 
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Softbank( 日 本 ) .Telefonica( 西 班 牙 ) 和 Vodafone( 英 国 ) ,如 图 1.6 所 示 。 
中 国 移动 通信 mr "P 
Өз MDDI dócomo с мое. BA 
1 
Еетион „Ф — SoftBank 图 9. 


图 1.6 电信 运营 商 


ОНА 中 的 半导体 芯片 商 有 Audience( 美 国 )、AKM( 日 本 )、ARM (英国 )、Atheros 
Communications Ji [E] ) .Broadcom( : B8) ,Intel( 美 国 )、Marvell( 美 国 ) , nVIDIA (美国 )、 
Qualcomm X Fd) „SiRF (% F ) , Synaptics (美国 )、ST-Ericsson( 意 大 利 、 法 国 和 瑞典 ) 和 
Texas Instruments( 美 国 ) ,如 图 1.7 所 示 。 
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1.7 ”半导体 芯片 商 


ОНА 中 的 手机 硬件 制造 商 有 е 11280 , 华硕 ( 中 国 台 湾 ) Garmin CF ER 6 
湾 ) ,宏达电 (中 国 台 湾 )、LG( 韩 国 ) SEGE) 、 华 为 (中 国 )、 摩 托 罗 拉 ( 美 国 ) .索尼 爱 
立信 ( 日 本 和 瑞典 ) 和 东芝 (日 本 ) .Dell( 美 国 ) 和 中 兴 ( 中 国 ) ,如 图 1.8 所 示 。 
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1.8 手机 硬件 制造 商 


OHA 中 的 软件 厂商 有 Ascender Corp (美国 )、eBay (美国 )、 谷歌 ( 美 国 )、 
LivingImage( 日 本 )、NuanceCommunications (美国 )、Myraid (瑞士 )、Omron (Н Ж), 
PacketVideo( 美 国 ) .SkyPop( 美 国 ) .Svox( 8) .SONiVOX CE [8 ) RI Esmertec( 瑞 士 )， 
如 图 1. 9 所 示 。 

ОНА 中 的 商品 化 公司 有 Aplix Corporation (日 本 )、Noser Engineering (瑞士 )、 
Borqs( 中 国 )、TAT-The Astonishing( 瑞 典 ) 和 Teleca AB( 瑞 典 ) ,如 图 1. 10 所 示 。 
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图 1.9 软件 厂商 
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122 Android 发 展 史 


2007 年 11 月 5 日 ,开放 手机 联盟 成 立 ,由 电信 运营 商 、 半 导体 芯片 商 \ 手 机 硬件 制造 
商 、 软 件 厂 商 和 商品 化 公司 等 方面 的 34 个 组 织 构成 ,推动 
Android 平台 的 研发 和 推广 ,其 徽标 如 图 1. 11 所 示 。 


1. Android 1. 0 版 


2007 年 11 月 12 日 ,谷歌 发 布 Android SDK 预览 版 ,这 
是 第 一 个 对 外 公布 的 Android SDK, 为 发 布 正式 版 收集 用 
户 反 馈 。 

2008 Æ 4 H 17 日 ,谷歌 举办 总 共 1000 万 美金 的 
Android 开发 者 竞赛 ,奖励 最 有 创意 的 Android 程序 开发 1.11 开放 手机 联盟 微 标 
者 ,使 Android 平台 在 短 时 间 积 累 了 大 量 优秀 的 应 用 程序 ， 
涌现 出 像 cab4me( 出 租车 呼叫 ) BioWallet( 生 物 特征 识别 ) 和 CompareEverywhere( 实 时 
商品 查询 ) 等 极 具 创意 的 应 用 程序 。Android 开发 者 竞赛 作品 如 图 1. 12 所 示 。 

2008 年 8 月 28 日 ,谷歌 开通 Google Play. f Android 手机 下 载 需 要 使 用 的 应 用 程 
序 。 程 序 开发 人 员 可 以 将 自己 设计 的 Android 软件 上 传 到 Google Play ,并 决定 软件 是 否 
收取 费用 。 但 在 Google Play 上 销售 软件 需要 向 谷歌 支付 25 美元 的 注册 费 , 并 在 每 次 交 
易 中 将 30% 的 利润 支付 给 运营 商 。 

2008 #&9 H 23 日 ,谷歌 发 布 Android 1. 0 版 ,这 是 第 一 个 稳定 的 版 本 。1.0 版 的 
SDK 中 分 别提 供 了 基于 Windows、Mac 和 Linux 操作 系统 的 集成 开发 环境 ,包含 完整 高 
效 的 Android 模拟 器 和 开发 工具 ,以 及 详尽 的 说 明文 档 和 开发 示例 。 程 序 开发 人 员 可 以 
快速 掌握 Android 应 用 程序 的 开发 方法 ,同时 也 降低 了 开发 手机 应 用 程序 的 门槛 。 

2008 年 10 月 21 日 ,谷歌 公布 了 Android 平 台 的 源 代码 。Android 作为 开放 源 代码 


KA Android 简介 Z 


cab4me light - select pickup location @ a 1231AN 


Р 1.12 Android 开发 者 竞赛 作品 


的 手机 平台 ,任何 人 或 机 构 都 可 以 免费 使 用 Android, 并 对 它 做 出 改进 。 开 放 源 代码 的 
Android 有 利于 创新 ,能 够 为 用 户 提供 更 好 的 体验 。 同 时 也 意味 着 任何 厂商 都 可 以 推出 
基于 Android 的 手机 , 且 不 用 支付 任何 的 许可 费用 。Android 的 源 代 码 可 以 到 谷歌 的 官 
方 网 站 下 载 , 地 址 是 http://source. android. com, 如 图 1. 13 所 示 。 


апагоа Source Devices Accessories — Compatibility а 


Welcome їо the Android Open Source Project! 

Android is ап open-source software stack for a wide range of mobile devices and a corresponding open-source project led by Google, Here you can find 
heifornitn ол end tolamimaredbout tha Adr о here yeu can ete ustom s ss = 
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WHATS NEW. GETTING STARTED. 

Guidelines offered for configuring ART Explore the Source 

Android engineering offers detailed guidelines for configuring the Get the complete Android platform and medify and build it to suit your 

Android runtime (ART) with build and complation options including needs, You cen also contribute to the Android Open Source Project 

compilation fiters. repository to make your changes available to everyone else in the 
Android ecosystem. 


Audio introduces example FIFO implementation and 
latency test app Port Android to Devices 


Port the latest Android platform and 
create compelling devices that your 
customers want. 


[he Audio teem has added an example non-blocking FIFO 
implementation soecifically designed for appication code and ап 
example implementation of the Larsen test called 
stesTestFeedback.cpp. 

Build Accessories 


Nexus 7 and Nexus 10 build tag updated ТИЙИ ы у чыты. 


into Androids open accessory 
standard and build accessories to 
complement the wide variety of 
Android-powered devices. 


The LRX22G build tag now applies tc Nexus 10 and the flo variant of 
Nexus 7. 


Android 5.0 CDD released 


1.13 Android 源 代 码 的 下 载 网 站 


2008 年 10 H 22 日 ,第 一 款 Android 手机 T-Mobile GICHTC Dream) 在 美国 上 市 ， 
由 中 国 台湾 的 宏达电 (HTC) 公 司 制造 ,如 图 1.14 所 示 。 在 硬件 方面 ,该 手机 内 置 
528MHz 的 Qualcomm MSM 7201A 处 理 器 .有 192MB RAM 和 256MB ROM 的 内 存 空 
间 ,提供 侧面 滑动 的 全 键盘 ,支持 WIFI 功能 和 内 置 GPS 模块 ,支持 最 大 8GB 容量 的 
microSD 存储 卡 扩展 容量 ,支持 GSM/UMTS/GPRS/EDGE/HSDPA 网 络 ;在 软件 方 
面 ,该 手机 集成 了 众多 的 应 用 功能 ,包括 谷歌 的 地 图 功能 .YouTube 视频 功能 、 全 方位 的 
导航 定位 以 及 360 度 查看 浏览 目标 位 置 的 功能 。 
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2. Android 1.1 版 


2009 年 2 月 ,Android 1.1 正式 发 布 。 该 版 本 修正 了 1.0 版 本 存在 的 缺陷 ,如 设备 休 
眠 状态 的 稳定 性 问题 .邮件 冻结 问题 .POP3 链接 失败 问题 和 IMAP 协议 的 密码 引用 问题 
等 。 同 时 ,增加 了 新 的 特性 ,例如 当 用 户 搜 索 地 图 或 详细 查看 时 ,允许 用 户 对 地 图 进行 评 
论 ;允许 用 户 保 存 彩信 的 附件 ;为 了 更 加 容易 地 使 用 拨号 盘 , 拨 号 盘 可 以 显示 或 隐藏 在 通 
话 菜单 中 等 。 

2009 年 2 月 17 日 ,第 二 款 Android 手机 T-Mobile G2( HTC Magic) 正式 发 售 , 仍 然 
由 中 国 台湾 的 宏达电 制造 ,如 图 1.15 所 示 。T-Mobile G2 的 硬件 配置 与 T-Mobile G1 4 
本 相同 ,不 同 之 处 主要 在 于 将 内 存 空 间 从 256MB 提高 到 512MB ,并 略微 增加 了 电池 的 容 
量 , 以 提升 整 机 的 使 用 时 间 。T-Mobile G1 放弃 了 影响 手机 尺寸 的 滑动 全 键盘 设计 ,使 
T-Mobile G2 的 体积 (113X55X13.65mm) 比 T-Mobile G1(117. 7 X 55. 7 X 17. 1mm) 明 
显 减 小 。 


图 1.14 T-Mobile G1 1.15 T-Mobile G2 


3. Android 1. 5 版 


2009 ^E 4 H 15 H. Android 1. 5 正式 发 布 。 此 版 本 提升 了 性 能 表现 ,提高 了 摄像 头 
的 启动 速度 和 拍摄 速度 ,提高 了 GPS 位 置 的 获取 速度 ,使 浏览 器 的 滚动 更 为 平滑 ,提高 了 
获取 Gmail 中 对 话 列表 的 速度 等 。 在 新 特性 方面 .支持 了 软 键盘 、 中 文 显示 和 中 文 输入 
功能 ,并 可 以 将 视屏 录制 的 内 容 直 接 上 传 到 YouTube 上 。 

2009 年 6 月 24 日 ,中 国 台 湾 的 宏达电 发 布 了 第 三 款 Android 手机 НТС Hero, 在 
硬件 方面 ,使 用 Qualcomm MSM 7200A 处 理 器 .500 万 像素 摄像 头 ,提供 3. 5mm 的 耳机 
插 孔 。 在 软件 方面 ,首次 支持 Adobe Flash 和 支持 多 点 触 控 技 术 ,最 突出 的 改进 是 使 用 了 
HTC Sense 界面 ,使 HTC Hero 的 界面 异常 美观 .绚丽 ,如 图 1.16 所 示 。 


4. Android 2. 0 版 


2009 4Æ 10 月 28 日 ,Android 2. 0(Eclair) 发布 。 此 版 本 引入 了 大 量 新 特性 ,如 数字 
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开发 者 可 使 这 些 新 API 令 手机 与 各 种 联系 源 进行 同步 ,并 实现 点 对 点 连接 和 游戏 功能 。 
新 版 SDK 改进 了 图 形 架 构 性 能 ,可 以 更 好 地 利用 硬件 加 速 , 改 进 了 虚拟 键盘 ,使 操作 更 
为 便利 。 

2010 年 1 月 6 日 ,谷歌 公司 初次 发 布 了 自主 品牌 的 Android 手机 Google Nexus 
One, 如 图 1. 17 所 示 。 使 用 SnapDragon 1GHz Ab BB ge .3. 7 英寸 AMOLED 电容 屏 ,由 中 
国 台湾 的 宏达电 公司 代 工 生产 。Nexus One 搭载 纯净 的 Android 2. 1。 由 于 谷歌 出 品 的 
手机 系统 上 没有 额外 的 限制 和 多 余 的 功能 ,这 款 手 机 在 较 长 的 时 间 内 都 是 Android 软件 
理想 的 开发 和 测试 平台 。 


1.16 HTC Hero 1.17 Google Nexus One 


5. Android 2. 2 版 


2010 年 5 月 21 日 ,谷歌 发 布 Android 2. 2 版 (Froyo)。 此 版 本 在 企业 集成 .设备 管 
JR API, 性 能 .网络 共 享 .浏览 器 和 市 场 等 领域 都 提供 了 很 多 新 特性 。 借 助 于 新 的 Dalvik 
ЛТ 编译 器 ,CPU 密集 型 应 用 的 速度 要 比 Android 2. 1 ft 2—5 倍 , 并 加 入 对 Adobe Flash 
视频 和 图 片 的 完美 支持 。 在 网 络 共享 方面 ,通过 手机 提供 的 热点 ,将 多 个 设备 节点 连接 
到 互联 网 上 。 在 浏览 器 方面 ,由 于 使 用 了 Chrome V8 引擎 ,JavaScript 代码 的 处 理 速度 
要 比 Android 2. 1 ft 2 —3 fÑ. Android 2. 2 的 最 大 改进 是 可 以 将 应 用 程序 安装 在 
microSD 卡 上 ,应 用 程序 可 以 在 内 部 存储 器 和 外 部 存储 器 上 迁移 。 


6. Android 2.3 版 


2010 年 12 月 7 日 .Android 2. 3(Gingerbread) 正 式 发 布 。 此 版 本 主要 增强 了 对 游 
戏 、 多 媒体 影音 和 通信 功能 的 支持 。 在 游戏 方面 ,增加 了 新 的 垃圾 回收 和 优化 处 理事 件 ， 
以 提高 对 游戏 的 支持 能 力 ,原生 代码 可 直接 存 取 输 入 和 感应 器 事件 .EGL/VOpenGL ES, 
OpenSL ES, 并 增加 了 新 的 管理 窗口 和 生命 周期 的 框架 。 在 多 媒体 影音 方面 ,支持 VP8 
和 WebM 视频 格式 ,提供 AAC 和 AMR 宽频 编码 ,提供 了 新 的 音频 效果 器 ,比如 混 响 , 均 
衡 \ 虚 拟 耳 机 和 低频 提升 。 在 通信 方面 ,支持 前 置 摄像 头 、SIP/VolP 和 NFC( 近 场 通信 ) 
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2010 年 12 月 7 日 ,谷歌 公司 发 布 了 第 二 款 自主 品牌 的 Android 手机 Google Nexus 
S, 如 图 1.18 所 示 。Nexus S 用 Cortex A8 处 理 器 ,默认 频率 为 1GHz,512MB 的 RAM 
和 16GB 的 内 置 闪存 ,但 不 支持 存储 卡 扩 展 ,4.0 英寸 WVGA(480X 800) 分 辩 率 电容 触 
摸 屏 幕 。Nexus S 支持 AGPS ,支持 Bluetooth 2. 1 十 EDR .支持 WiFi 802. 11 n/b/g, 支 持 
МЕС 技术 ,支持 三 轴 陀 螺 仪 ,加速 计 、 数 字 罗 盘 .光线 感应 器 和 距离 感应 器 。Nexus S f 
载 最 新 的 Android 2. 3 ,是 第 一 款 具备 МЕС 功能 的 Android 手机 。 


7. Android 3. 0 版 


2011 年 2 月 3 日 ,Android 3.0 版 本 (Honeycomb) 正 式 发 布 。 这 是 专 为 平板 电脑 设 
计 的 Android 系统 ,因此 在 界面 上 更 加 注重 用 户 体 验 和 良好 互动 性 。 重 新 定义 了 多 任务 
处 理 功能 ,丰富 了 提醒 栏 ,支持 Widgets, 并 允许 用 户 自 定义 主 界面 。Android 3. 0 原生 支 
持 文件 /图 片 传输 协议 ,允许 用 户 通 过 USB 接口 连接 外 部 设备 以 同步 数据 ,或 通过 USB 
或 蓝牙 连接 实体 键盘 进行 更 快速 的 文字 输入 ,改进 了 WiFi 连接 ,搜索 信号 速度 更 快 ,并 
可 通过 蓝牙 进行 tether 连接 ,分 享 3G 信号 给 其 他 设备 。 

2011 年 1 月 6 日 ,摩托 罗拉 发 布 了 第 一 款 Android 3. 0 的 平板 电脑 Motorola Xoom, 
如 图 1. 19 所 示 。 硬 件 上 采用 双核 1GHz NVIDIA Tegra 2 处 理 器 ,10. 1 寸 1280X800 分 
辨 率 的 触摸 屏 ,内 置 有 32GB 存储 ,并 配 有 前 置 与 后 置 摄像 头 , 支 持 高 清 视频 录制 和 播放 
功能 。Motorola Xoom 才 是 真正 意义 上 的 Android 平板 电脑 ,也 是 Android 系统 的 一 个 
里 程 碑 。 


图 1.18 Google Nexus S 图 1.19 Motorola Xoom 


8. Android 3. 1 版 


2011 4F 5 H 10 Н. Android 3.1 版 本 正式 发 布 。 作 为 Android 3. 0 的 升级 版 ， 
Android 3. 1 界面 上 做 了 一 些 美化 与 调整 ,从 桌面 到 程序 集 菜单 的 动画 转 场 更 为 顺畅 , 界 
面 上 的 文字 颜色 与 位 置 也 稍微 调整 ,还 加 入 了 全 系统 适用 的 声音 回馈 。 增 加 了 对 USB 
设备 的 支持 ,如 USB 和 鼠标、 键盘 和 游戏 控制 器 等 。Widget 允许 用 户 通过 拖 忠 修改 外 观 尺 
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才 , 将 Widget 放大 后 可 显示 更 为 详细 的 信息 。Android 3. 1 除了 支持 许多 新 标准 与 功能 
外 ,内 建 的 应 用 程序 也 做 了 一 些 更 新 ,更 适合 平板 电脑 使 用 。 


9. Android 4. 0 版 


2011 Æ 10 H 19 H .Android 4. 0 版 本 (Ice Cream Sandwich) 正 式 发 布 , 如 图 1. 20 所 
一 版 本 最 显著 的 特征 是 同时 支持 智能 手机 、 平 板 电脑 .电视 等 设备 ,而 不 需要 根据 
设备 不 同 选择 不 同 版 本 的 Android 系统 。 该 版 本 取消 
了 底部 物理 按键 的 设计 ,直接 使 用 虚拟 按键 ,在 增 大 屏 
幕 面积 的 同时 控制 手机 整体 大 小 ,而 且 这 样 的 操作 方式 
可 以 使 智能 手机 与 平板 电脑 保持 一 致 。 人 脸 识别 功能 
在 4.0 版 本 中 得 到 应 用 ,用 户 可 以 使 用 自拍 相片 设置 屏 
幕 锁 ,Android 系统 根据 脸 部 识别 结果 控制 手机 的 解锁 
功能 。 另 一 个 有 趣 的 应 用 是 基于 NFC 的 Android 
Beam 功能 ,可 以 让 两 部 手机 在 接近 到 4cm 后 交换 信 
息 , 可 交换 的 内 容 包括 网 站 、 联 系 人 .导航 \YouTube 视 
,甚至 电子 市 场 的 下 载 链接 也 可 交换 。 


10. Android 4. 2 版 


2012 年 10 月 29 日 ,Android 4. 2 版 本 (Jelly Bean) 
正式 发 布 。 此 版 本 主要 在 Photo Sphere 全 景 拍 照 .键盘 
手势 输入 .Miracast 无 线 显 示 共 享 . 手 势 放 大 缩小 屏幕 
以 及 为 盲人 用 户 设计 的 语音 输出 和 手势 模式 导航 功能 。。 图 1 20 Android 4.0 版 本 
等 方面 做 了 重大 改进 与 升级 。 该 版 本 的 亮点 是 支持 行 
业 标 准 的 WiFi 显示 共享 工具 Miracast, 人 允许 Nexus 4 向 电视 流传 输 音频 和 视频 。 在 浏 
览 器 方面 ,支持 选项 卡 浏览 Vulp 步 ,使 手机 和 平板 电脑 的 使 用 与 传统 PC 使 用 
无 异 ; 在 文件 管理 方面 , 它 一 个 全 新 的 文件 管理 器 ,使 用 户 方便 地 管理 SD 卡 上 的 文 
件 , 而 不 需要 依赖 于 第 -= 方 软件 ， 在 系统 自 带 时 钟 方面 ,Android 4. 2 取得 了 飞跃 式 的 进 
步 ,使 原本 缺失 的 世界 时 钟 .计时 器 和 秒表 功能 都 实现 了 。 


11. Android 4.4 版 


2013 Æ 9 Н 4 H , Android 4. 4 版 本 (KitKat) 正 式 发 布 ,如 图 1. 21 所 示 。 此 版 本 支 
持 两 种 编译 模式 ,除了 默认 的 Dalvik 模式 ,还 支持 ART 模式 。 对 内 存 使 用 做 了 进一步 
的 优化 ,在 一 些 硬件 配置 较 低 的 设备 上 仍 可 以 良好 地 运行 ,甚至 可 以 在 仅 有 512MB 内 存 
的 老 款 手机 上 流畅 运行 。 增 加 了 低 功 耗 音频 和 定位 模式 ,进一步 降低 了 设备 的 能 量 消 
耗 。 新 版 本 增加 了 新 的 蓝牙 配置 文件 ,可 以 支持 更 多 的 设备 ,包括 鼠标 、 键 盘 和 手柄 ,还 
能 够 与 车 载 蓝牙 交换 地 图 , 功 耗 也 更 低 。 另 外 增强 了 红外 线 兼 容 性 ,新 的 红外 线 遥 控 接 
口 可 以 支持 更 多 设备 ,包括 电视 .开关 等 。 
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12. Android 5. 0 版 


2014 4E 10 H 15 H , Android 5. 0 版 本 (Lollipop) 正 式 发 布 ,如 图 1.22 所 示 。 它 采用 
全 新 Material Design 界面 ,各 种 界面 小 部 件 可 以 重 和 琶 摆 放 。 编 译 模式 也 由 ART 取代 
Dalvik 成 为 默认 选项 ,这 种 预 编 译 操 作 由 原本 在 程序 运行 时 进行 提前 到 用 户 应 用 安装 时 
进行 ,应 用 运行 效率 也 随 之 提高 ,其 性 能 可 提升 4 倍 。 由 于 “多 构 ” 取 代 “ 多 核 ” 成 为 硬件 
发 展 趋势 ,更 丰富 的 传感器 将 被 引入 ,并 且 支 持 64 位 处 理 器 。 在 系统 功能 方面 ,新 增 了 
自动 内 容 加 密 功 能 和 多 人 设备 分 享 功能 ,提供 低 视力 设置 ,协助 色弱 认识 。 


图 1.21 Nexus s 上 的 Android 4. 4 1.22 Android 5.0 


13 Android f Е 


Android 广泛 支持 GSM、3G ffl 4G 的 语音 与 数据 业务 ,支持 接收 语言 呼叫 和 SMS 短 
信 ,支持 数据 存储 共享 和 IPC 消息 机 制 ,为 地 理 位 置 服务 (如 GPS) .谷歌 地 图 服务 提供 易 
于 使 用 的 API 函数 库 ,提供 组 件 复 用 和 内 置 程序 替换 的 应 用 程序 框架 ,提供 基于 WebKit 
的 浏览 器 ,广泛 支持 各 种 流行 的 视频 .音频 和 图 像 文 件 格式 ,支持 的 格式 有 MPEG4、 
H264, MP3, AAC, AMR,JPG,PNG 和 GIF, 为 2D 和 3D 图 像 处 理 提供 专用 的 API Ж 

Android 系统 提供 了 访问 硬件 的 API 库 函 数 , 用 来 简化 像 摄像 头 、GPS 等 硬件 的 访 
问 过 程 。 只 要 支持 Android 应 用 程序 框架 的 手机 ,对 硬件 访问 的 方法 是 完全 一 致 的 , 因 
此 即使 将 应 用 程序 移植 到 不 同 硬件 配置 的 手机 上 ,也 无 须 修 改 应 用 程序 对 硬件 的 访问 方 
ik. Android 支持 的 硬件 包括 GPS 摄像头、 网 络 连接 、WiFi、 蓝 牙 .NFC、 加 速度 计 、 触 摸 
屏 和 电源 管理 等 。 

在 内 存 和 进程 管理 方面 ,Android 具有 自己 的 运行 时 和 虚拟 机 。 与 Java 和 . NET 运 
行 时 不 同 ,Android 运行 时 还 可 以 管理 进程 的 生命 周期 。Android 为 了 保证 高 优先 级 进 
程 运 行 和 正在 与 用 户 交 互 进程 的 响应 速度 ,允许 停止 或 终止 正在 运行 的 低 优先 级 进程 ， 
以 释放 被 占用 的 系统 资源 。Android 进程 的 优先 级 并 不 是 固定 的 ,而 是 根据 进程 是 否 在 
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前 台 或 是 否 与 用 户 交互 而 不 断 变 化 的 。Android 生命 周期 和 调试 的 相关 内 容 将 在 第 4 章 
进行 介绍 。 

在 界面 设计 上 ,Android 提供 了 丰富 的 界面 控件 供 使 用 者 调用 ,从 而 加 快 了 用 户 界 面 
的 开发 速度 ,也 保证 了 Android 平台 上 的 程序 界面 的 一 致 性 。Android 将 界面 设计 与 程 
序 逻 辑 分 离 ,使 用 XML 文件 对 界面 布局 进行 描述 ,有 利于 界面 的 修改 和 维护 。 用 户 界面 
的 相关 内 容 将 在 第 5 章 进 行 介绍 。 

Android 提供 轻 量 级 的 进程 间 通 信 机 制 Intent, 使 跨 进程 组 件 通 信和 和 发送 系 统 级 广 
播 成 为 可 能 。 通 过 设置 组 件 的 Intent 过 滤器 ,组 件 通过 匹配 和 筛选 机 制 , 可 以 准确 地 获 
取 到 可 以 处 理 的 Intent。 组 件 通信 与 广播 消息 的 相关 内 容 将 在 第 6 章 进行 介绍 。 

Android 提供 了 Service 作为 无 用 户 界 面 .长 时 间 后 台 运 行 的 组 件 。Android 是 多 任 
务 系 统 ,但 受到 屏幕 尺寸 的 限制 ,同一 时 刻 只 允许 一 个 应 用 程序 在 前 台 运行 。Service 无 
须 用 户 干 预 ,可 以 长 时 间 、 稳 定 地 运行 ,可 为 应 用 程序 提供 特定 的 后 台 功 能 ,还 可 以 实现 
事件 处 理 或 数据 更 新 等 功能 。 后 台 服 务 相 关内 容 将 在 第 7 章 进 行 介 绍 。 

Android 支持 高 效 , 快 速 的 数据 存储 方式 ,包括 快速 数据 存储 方式 
SharedPreferences ,文件 存储 和 轻 量 级 关系 数据 库 SQLite, 应 用 程序 可 以 使 用 适合 的 方 
法 保存 和 访问 数据 进程 。 同 时 ,为 了 便于 跨 进 程 共 享 数据 ,Android 提供 了 通用 的 共享 数 
据 接口 ContentProvider, 可 以 无 须 了 解数 据 源 、 路 径 的 情况 下 ,对 共享 数据 进行 查询 、 添 
加 、 删 除 和 更 新 等 操作 。 数 据 存储 与 访问 相关 内 容 将 在 第 8 章 进行 介绍 。 

Android 支持 位 置 服务 和 地 图 应 用 ,可 以 通过 SDK 提供 的 API 直接 获取 当前 的 位 
置 ,追踪 设备 的 移动 路 线 , 或 设 定 敏感 区 域 ,并 可 以 将 Google Hb [EL Л 9] Android 应 用 
程序 中 ,实现 地 理 信息 可 视 化 开发 。 位 置 服务 和 地 图 应 用 的 相关 内 容 将 在 第 9 章 进行 
介绍 。 

Android 支持 Widget 插件 ,可 以 方便 地 在 Android 系统 上 开发 桌面 应 用 ,实现 比较 
常见 的 一 些 桌 面 小 工具 ,或 在 主屏 上 显示 重要 的 信息 。 随 着 Android 系统 可 以 在 平板 电 
脑 上 使 用 , Widget 插件 的 实用 性 在 不 断 提高 。Android Widget 的 相关 内 容 将 在 第 10 章 
进行 介绍 。 

Android 支持 使 用 本 地 代码 (C 或 C++ ) 开 发 应 用 程序 的 部 分 核心 模块 ,提高 了 程序 
的 运行 效率 ,并 有 助 于 增加 Android 开发 的 灵活 性 。Android 本 地 代码 开发 的 相关 内 容 
将 在 第 11 章 进行 介绍 。 


14 Android 体系 结构 


Android 是 基于 Linux 内 核 的 软件 平台 和 操作 系统 ,采用 了 软件 堆 层 (Software 
Stack) 的 架构 , 共 分 为 4 层 ,如 图 1. 23 所 示 。 第 一 层 是 Linux 内 核 ,提供 由 操作 系统 内 核 
管理 的 底层 基础 功能 ;第 二 层 是 中 间 件 层 , 由 函数 库 和 Android 运行 时 构成 ;第 三 层 是 应 
用 程序 框架 层 , 提 供 了 Android 平台 基本 的 管理 功能 和 组 件 重用 机 制 ;第 四 层 是 应 用 程 
序 层 ,提供 了 一 系列 核心 应 用 程序 。 

Android 平台 的 底层 使 用 的 是 Linux 3. 0 内 核 . 硬 件 和 其 他 软件 堆 层 之 间 的 一 个 抽 
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邮件 客户 端 通讯 录 浏览 器 


应 用 程序 框架 


Activity Window Content View 
Manager Manager Providers System 


Package Telephony Resource Location Notification 
Manager Manager Manager Manager Manager 


函数 库 Android 运行 时 


Media i A 
Surface Manager Framework 


ART 虑 拟 机 
OpenGL | ES FreeType 


Linux 内 核 


内 存 管理 进程 管理 网 络 协议 栈 


电源 管理 КИЙЕ ХЕЛ 显示 驱动 


1.23 Android 体系 结构 


象 隔离 层 。 提 供 安 全 机 制 . 内 存 管理 进程 管理 .网 络 协议 堆栈 、 电 源 管理 和 驱动 程序 等 ， 
驱动 程序 包括 WiFi 驱动 .声音 驱动 .显示 驱动 .摄像 头 驱动 .闪存 驱动 .Binder(IPC) 驱 动 
和 键盘 驱动 等 。 

函数 库 在 Linux 内 核 之 上 ,提供 了 一 组 基于 C/C ++ 的 函数 库 ,程序 开发 人 员 可 以 通 
过 应 用 程序 框架 调用 这 т 要 的 函数 库 包 括 : 

* Surface Manager. 支持 显示 子 系统 的 访问 ,为 多 个 应 用 程序 提供 2D、3D 图 像 层 的 
平滑 连接 ; 
* Media Framework, 基 于 OpenCORE 的 多 媒体 框架 ,实现 音频 、 视 频 的 播放 和 录 
制 功能 ,广泛 支持 多 种 流行 的 音 视 频 格 式 , 包 括 МРЕСА, H. 264, МРЗ, ААС, 

AMR JPG fll PNG 等 ; 
* SQLite, 轻 量 级 的 关系 数据 库 引 擎 ; 
* OpenGL ES, 基 于 硬件 的 3D 图 像 加 速 
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。 FreeType, 位 图 与 矢量 字体 泻 染 ; 

e WebKit, Web 浏览 器 引擎 ; 

* SGL.2D 191%; 

• SSL ,数据 加 密 与 安全 传输 的 函数 库 ; 

。 libc, 标 准 C 运行 库 , 是 Linux 系统 中 底层 的 应 用 程序 开发 接口 。 

Android 运行 时 由 核心 库 和 ART 虚拟 机 构成 。 核 心 库 为 程序 开发 人 员 提 供 了 
Android 系统 的 特有 函数 功能 和 Java 语言 基本 函数 功能 。ART 虚拟 机 采用 预 编译 
(AOT,ahead of time) 技 术 , 在 应 用 程序 安装 时 把 程序 代码 转换 成 机 器 语言 ,加 快 了 启动 
速度 ,并 且 使 用 应 用 程序 的 运行 速度 更 快 ,电量 消耗 更 少 , 系 统 也 更 加 流畅 。 

应 用 程序 框架 提供 了 Android 平 台 基 本 的 管理 功能 和 组 件 重用 机 制 , 包 括 Activity 
管理 、 窗 体 管理 ` 包 管理 .电话 管理 ,资源 管理 .位 置 管理 .通知 消息 管理 .View 系统 和 内 
容 提 供 者 等 。ContentProviders 用 来 共享 私有 数据 ,实现 跨 进程 的 数据 访问 ;Resource 
Manager 允许 应 用 程序 使 用 非 代 码 资源 ,如 图 像 , 布 局 和 本 地 化 的 字符 串 等 ;Notification 
Manager 允许 应 用 程序 在 状态 栏 中 显示 提示 信息 ; Activity Manager 用 来 管理 应 用 程序 
的 生命 周期 ;Window Manager 用 来 启动 应 用 程序 的 窗 体 ;Location Manager 用 来 管理 与 
地 图 相关 的 服务 功能 ;Telephony Manager 用 来 管理 与 拨打 和 接听 电话 相关 的 功能 ; 
Package Manager 用 来 管理 安装 在 Android 系统 内 的 应 用 程序 。 

应 用 程序 提供 了 一 系列 核心 应 用 程序 ,包括 电子 邮件 客户 端 ,浏览 器 、 通 讯 录 日历、 
相册 、 地 图 和 电子 市 场 等 。 


= 题 


1. 简 述 各 种 的 手机 操作 系统 的 特点 。 
2. 简 述 Android 平台 的 特征 。 
3. 描述 Android 平台 体系 结构 的 层次 划分 ,并 说 明 各 个 层次 的 作用 。 


Android 开发 环境 


Android 开发 环境 的 安装 与 配置 是 开发 Android 应 用 程序 的 第 一 步 ,也 是 深入 理解 
Android 系统 的 一 个 良好 途径 。 通 过 本 章 的 学 习 , 读 者 可 以 掌握 Eclipse 和 Android 
Studio 两 种 开发 环境 的 安装 和 配置 方法 ,理解 Android SDK I ADT 插件 的 用 途 ,熟悉 在 
应 用 程序 开发 过 程 中 可 能 会 使 用 到 的 开发 工具 。 

本 章 学 习 目 标 : 

。 掌握 Eclipse 和 Android Studio 的 安装 配置 方法 ; 

。 了 解 Android Studio 的 安装 配置 方法 ; 

。 了 解 Android SDK 的 目录 结构 和 示例 程序 ; 

。 掌握 各 种 Android 开发 工具 的 用 途 。 
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Eclipse 是 开发 Android 应 用 程序 的 首选 集成 开发 环境 。Eclipse 作为 开源 的 Java Ж 
发 环境 ,功能 强大 ,易于 使 用 。Android 提供 了 在 Eclipse 上 开发 Android 应 用 程序 的 
ADT 插件 (Android Development Toolkit. АРТ). {ЕТ Android 应 用 程序 的 开发 、 运 
行 和 调试 。 
安装 Android 开发 环境 ,首先 需要 安装 支持 Java 应 用 程序 运行 的 Java 开发 工具 包 
(Java Development Kit,JDK) ,然后 再 按 顺 序 安装 Eclipse、 Android SDK 和 ADT。 安装 
过 程 中 可 能 会 遇 到 网 络 地 址 无 法 访问 的 问题 ,请 使 用 特殊 方法 解决 访问 外 网 问题 。 


211 安装 JDK 和 Eclipse 


在 开始 下 载 和 安装 Eclipse 之 前 ,应 该 首先 确认 开发 主机 上 已 经 安装 了 Java 运行 环 
境 (Java Runtime Environment, JRE). X Eclipse 是 用 Java 语言 编写 的 应 用 程序 , 需 
要 JRE 才能 运行 。 如 果 JRE 没有 安装 或 者 没有 被 检测 到 ,尝试 打开 Eclipse 时 会 有 错误 
提示 ,如 图 2. 1 所 示 。 

安装 JRE 的 系统 可 以 运行 Java 应 用 程序 ,但 如 果 需 要 进行 Java 应 用 程序 的 开发 ,应 
该 直接 安装 JDK。 因 为 JDK 中 包含 完整 的 JRE, 所 以 只 要 安装 JDK 后 ,JRE 也 自动 安装 
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А Java Runtime Environment (JRE) or Java Development Kit (ЛК) 
must be available in order to run Eclipse. No Java virtual machine 


was found after searching the following locations: 
E: \Android\eclipse\jre\bin\javaw. ехе 
javaw.exe in your current PATH 


ЖЕ) 


图 2.1 没有 安装 JRE 的 错误 提示 


在 操作 系统 中 。 
JDK 的 基本 组 件 包括 : 编译 器 ,将 源 程序 转 成 字 节 码 ; 打 包工 具 , 将 相关 的 类 文件 打 
包 成 一 个 文件 ;文档 生成 器 ,从 源码 注释 中 提取 文档 ; 查 错 工具 ,用 来 进行 调试 和 差错 。 
JDK 可 以 到 Oracle 的 官方 网 站 下 载 ,在 浏览 器 中 输入 网 址 http://www. oracle. 
com/technetwork/java/javase/downloads/index. html, 显示 的 页 面 如 图 2. 2 所 示 , 然 后 
单 击 Java SE 8u40 中 的 JDK Download 按钮 ,进入 JDK 的 下 载 页 面 。 


Java SE 8u40 

This latest release of Oracle's implementation of Java SE, JDK 8u40, brings improvements to 
performance, scalability and administration, making it easier for Java developers, partners and 
IT decision makers to innovate faster in a simple, easy manner and improve application 
services. The release also includes new updates to JavaFX. Full release notes can be found 


here. 
Learn more » 
* Installation Instructions JDK 
DOWNLOAD * 
* Release Notes 
* Oracle License Server JRE 


* Java SE Products 


* Third Party Licenses 
JRE 


* Certified System Configurations 


* ReadmeFiles 
* JDKReadMe 


* JREReadMe 


2.2 JavaSE 选择 页 面 


在 JDK 的 下 载 页 面 中 ,首先 需要 同意 Oracle 的 Java SE 二 进 制 代码 协议 ,选择 
Accept License Agreement, 然 后 根据 用 户 的 系统 选择 不 同 版 本 的 JDK。 如 果 是 32 位 的 
Windows 系统 ,选择 下 载 Windows x86; 如 果 是 64 位 的 Windows 系统 ,选择 下 载 
Windows x64, 如 图 2.3 所 示 。 

笔者 使 用 的 是 64 位 的 Windows 7 系统 ,因此 选择 下 载 Windows x64, 文 件 的 名 称 为 
jdk-8u40-windows-x64. exe. 

在 JDK 的 安装 过 程 中 ,一 般 情况 下 保持 JDK 的 默认 设置 即 可 ,JDK 会 安装 在 C:\ 
Program File\Java\jdk1. 8.0_40\ 目 录 下 ,如 图 2.4 所 示 。 

在 JDK 安装 完毕 后 ,安装 程序 提示 “Java(TM) SE Development Kit 7(64-bit) 已 经 
成 功 安 装 ”, 如 图 2. 5 所 示 。 下 一 步 可 以 进行 Eclipse 的 安装 工作 。 
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You must accept the Oracle Binary Code License Agreement for Java SE to download this 


Thank you for accepting the Oracle В Code License Agreement for Java SE; 


Product File Descfipti - Hie Size D 


Linux x86 146.85 MB Š jdk.8u40-linux-i586.rpm 


Linux x86 166.82MB š jdk-8u40-linux-i586.tar.gz 

Linux x64 145.14 MB $ jdk-8u40-linux-x64.rpm 

Linux x64 165.19 MB % jdk.8u40-linux-x64.tar.gz 

Mac OS X x64 22189MB  $ jdk.8u40-macosx-x64.dmg 

Solaris SPARC 64-bit (SVR4 package) 131.59 МВ š jdk-8u40-solaris-sparcv9.tar.Z 

Solaris SPARC 64-bit 9283MB š jdk.8u40-solaris-sparcv9.tar.gz. 

Solaris x64 (SVR4 package) 139.45 МВ Š jdk-8u40-solaris-x64.tar.Z 

Solaris x64 9582MB $ jdk-8u40-solaris-x64.tar.gz 
17571MB š jdk-8u40-windows-i586.exe 
180.19 MB jdk-8u40-windows-x64.exe 


2.3 JKD 下 载 页 面 


列表 中 选择 要 安装 的 可 和 功能。 您 可 以 在 安装 后 使 用 近 制 面板 中 的 "添加 出 辽 程序 " 
Enon d > 


安装 到 : 
C:\Program Files\Javajdk1.8.0_40\ 


2.4 JDK 的 默认 设置 
Java SE Development Kit 8 Update 40 (64-bit) 
& 
x Јама" 


Java SE Development Kit З Update 40 (64-bit) 已 成 功 安装 


Ai ESRDE, АРІ 文档 , 开发 人 员 指南 , 发 布 说 明 及 更 多 内 容 , 帮助 你 
开始 使 用 ]DK。 


БЁР) 


图 2.5 JDK 安装 成 功 界面 
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安装 完 JDK 后 ,还 需要 进行 Java 环境 变量 的 配置 ,配置 方法 在 此 不 再 袭 述 。 
可 以 在 浏览 器 输入 http://www. eclipse. org/downloads 来 下 载 Eclipse。 进 入 


Eclipse 的 下 载 页 面 ,在 “Eclipse IDE for Java Developers ”项 目 中 ,根据 自身 操作 系统 的 
版 本 ,选择 下 载 32 位 或 64 位 版 本 的 Eclipse. Ш 2.6 所 示 。 
Eclipse Luna SR2 (4.4.2) Release for MIETTE 


4 Windows 32 


e] Eclipse IDE for Java Developers. 155 ме s: 
Downloaded 411,273 Times mem sd 
Windows 64 
The essential tools for any Java developer, including a Java IDE, a CVS Bit 
client. Git client. XML Editor. Mylyn. Maven integration... 


2.6 Eclipse 下 载 页 面 


FRH Eclipse 是 一 个 zip 文件 。 笔 者 下 载 的 是 64 位 版 本 的 Eclipse, 文 件 名 为 
eclipse-java-luna-SR2-win32-x86_64. zip。 直 接 将 zip 文件 中 的 eclipse 文件 夹 解 压缩 到 
指定 的 目录 中 即 可 。 双 击 目录 中 的 eclipse. exe 文件 ,出 现 Eclipse 集成 开发 环境 的 启动 
画面 ,如 图 2.7 所 示 。 如 果 没 有 出 现 启动 画面 ,可 以 尝试 重新 启动 计算 机 。 


p eclipse 


LUNA 


Eclipse 启动 时 会 提示 用 户 选 择 默 认 工 作 目 录 , 以 后 创建 的 工程 将 保存 在 这 个 工作 目 
录 下 。 默 认 工作 目录 的 路 径 是 系统 的 用 户 目录 ,建议 用 户 选择 其 他 位 置 保 存 Android Т. 
程 。 笔 者 选择 的 工作 目录 是 D:\Android\workplace, 如 图 2.8 所 示 。 建 议 选择 复 选 框 
Use this as the default and do not ask again, 将 选择 的 工作 目录 作为 默认 工作 目录 ,不 必 


每 次 启动 时 都 重新 选择 工作 目录 。 


EE 


Select a workspace 
Eclipse stores your projects in a folder called a workspace. 
Choose a workspace folder to use for this session. 


2.7 ”Eclipse 启动 画面 


Workspace: DAAndroidWorkplace 


[V] Use this as the default and do not ask again 


] 


mc 


图 2.8 Eclipse 工作 目录 设 定 


20 esa (узж) 
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sk 


启动 后 的 Eclipse 集成 开发 环境 如 图 2. 9 所 示 。 


2.9 Eclipse 集成 开发 环境 


到 此 为 止 ,Eclipse 和 JDK 已 经 安装 完毕 ,但 在 创建 Android 工程 之 前 ,还 需要 下 载 
和 安装 Android SDK 和 ADT 的 插件 ,并 完成 Eclipse 的 相关 设置 。 


212 安装 Android SDK 


Android SDK 是 Android 软件 开发 工具 包 (Android Software Development Kit) ,是 
为 了 提高 Android 应 用 程序 开发 效率 、 缩 短 开 发 周期 而 提供 的 辅助 开发 工具 .开发 文档 
和 程序 范例 。 

从 Google 的 Android 开发 者 网 站 主页 可 以 下 载 最 新 的 Android SDK ,网 页 地 址 为 
http://developer. android. com/index. html。 这 里 有 大 量 关 于 Android 的 开发 信息 , 包 
括 SDK ,开发 文档 ,参考 索引 和 示例 代码 等 ,下 载 页 面 如 图 2. 10 所 示 。 

Android SDK 的 下 载 地 址 是 http://developer. android. com/sdk/index. html & 
Other, 在 页 面 中 可 以 选择 下 载 不 同 操作 系统 版 本 的 Android SDK。 如 图 2. 11 所 示 , 虽 
IR Google 推荐 下 载 可 执行 文件 (installer_r24. 0. 2-windows. exe) 版 本 ,但 下 载 Windows 
的 zip(android-sdk_r24. 0. 2-windows. zip) 版 本 也 是 不 错 的 选择 。 读 者 下 载 的 installer_ 
т24. 0. 2-windows. exe 或 android-sdk_r24. 0. 2-windows. zip 只 是 SDK 的 安装 工具 ,真正 
的 SDK 版 本 选择 和 下 载 将 在 后 面 进行 。 

笔者 选择 下 载 android-sdk_r24. 0. 2-windows. zip 文件 ,将 zip 文件 解压 到 硬盘 上 的 
任意 目录 中 ,笔者 将 Android SDK 解压 到 D:\Android SDK\android-sdk 目录 中 。 然 后 
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Ë Developers ~ | Design Develop Distribute а 


Android 5.0 Lollipop 


The Android 5.0 update adds a variety of 
new features for your apps, such as 
notifications on the lock screen, an all-new 
camera API, OpenGL ES 3.1, the new 
Material design interface, and much more. 


Learn More 


Download Android Studio 
С and SDK Tools 

Download the official Andioid IDE. 
ard dereiopertools to build ap 


Building Apps fcr 
Wearables 

Learn how to build rotficaions, 
send and sye data, ard use v 


В Creating Apps with 
Material Design 


sam how to apply material design 
your apps. 


Get the SDK » Browse Samples » Watch Videos » Manage Your Apps » 


2.10 Google 的 Android 项 目 主 页 


Platform | Package SHA-1 Checksum 
Windows installer r24.0.2-windows.exe 91428280 edac14e1541697d68821fa3a709b4ea8c6596676 
(Recommended) bytes 
android-sdk r24.0.2- 139473113 — 51269c8336f036íc9b9538f9b9ca236b78fb4e4b 
windows.zip bytes 
MacOSX  android-sdk r24.0.2-macosx.zip 87262823 3ab5e0ab0db5e7c45de9da7ff525dee6cfa97455 
bytes 
Linux android-sdk r24.0.2-linux.tgz 140097024 b6fd75e8b06b0028c2427e6da7d8a09d8f056a86 
bytes 


2.11 Android 开发 站 点 主页 面 


运行 目录 中 的 “SDK 管理 器 "(SDK Manager. exe) ,下 载 最 新 的 版 本 Android SDK. 

SDK 管理 器 运行 后 自动 获取 可 下 载 的 SDK 列表 和 辅助 工具 列表 ,耐心 等 待 后 将 显 
示 所 有 可 下 载 的 内 容 , 如 图 2. 12 所 示 。 为 了 安装 SDK ,至 少 需要 有 最 新 的 开发 工具 与 
Android 平台 ,需要 下 载 的 有 Tools 目录 下 的 Android SDK Tools, Android SDK 
Platform-tools 以 及 最 新 版 的 Android SDK Build-tools。 另 外 还 需 下 载 最 新 版 本 的 
Android ,目前 最 新 版 本 为 Android 5. 0. 1(API 21), 勾 选 其 中 的 SDK Platform, 另 外 选择 
任意 一 个 模拟 器 需要 使 用 的 镜像 文件 ,如 ARM EABI v7a System Image。 

打开 SDK 管理 器 时 ,程序 默认 会 勾 选 所 需 安装 的 文件 ,建议 初学 者 直接 按照 默认 勾 
选项 进行 下 载 。 单 击 Install X packages ,在 弹出 的 窗口 中 选择 Accept Licence 后 ,进入 下 
载 。 安 装 过 程 非常 漫长 ,在 安装 成 功 后 ,所 有 安装 包 的 状态 栏 (Status) 将 从 Not installed 
更 改 为 Installed, 

在 Eclipse 中 开发 Android 程序 ,还 需要 把 Android SDK 与 Eclipse 开发 环境 关联 起 
来 ,具体 的 关联 方法 将 在 下 一 节 进 行 介绍 。 
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Packages Tools 
SDK Path: DAAndroid SDK\android-sdk 
Packages 
局 Name 
» FIC Tools] 
4 nr Android 5.0.1 (API 21) 
[F] [& Documentation for Android SDK 
iW! SDK Platform 
I) Д Samples for SDK 
国 Android TV ARM EABI v7a System Image 
lB Android TV Intel x86 Atom System Image 
Android Wear ARM EABI v7a System Image 
Ей Android Wear Intel x86 Atom System Image j 
[V] EE ARM EABI v7a System Image f£ Installed 
E BIB /nte/ x86 Atom 64 System Image O Not installed 


Intel x86 Atom System Image (1 Not installed 
El $ Google APIs f Installed 
回国 Google APIs ARM EABI v7a System Image E Installed 
F| Els Google APIs Intel x86 Atom 64 System Imag O Not installed 
[F] ill Google APIs Intel x86 Atom System Image @ Update available: rev. 3 
Т Sources for Android SDK Ë% Installed 
> 165 Android 44W.2 (API 20) 
La FiF3Andrid 4.4.2 (АРІ19) — — — I i 
Show: [F] Updates/New VlInstalled Select New or Updates 


Obsolete Deselect All 


|| Fetching https://dl-ssLgoogle.com/android/repository/addons_list-2.xml| 


2.12 SDK 管理 器 的 建议 下 载 内 容 
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ADT 插件 是 Eclipse 开发 环境 的 定制 插件 ,为 开发 Android 应 用 程序 提供 了 一 个 强 
大 的 、 完 整 的 开发 环境 。 利 用 它 可 以 快速 地 建立 Android 工程 .用 户 界面 和 基于 Android 
API 的 组 件 , 还 可 以 在 Eclipse 中 使 用 Android SDK 提供 的 工具 进行 程序 调试 ,或 对 apk 
文件 进行 签名 等 。 

一 般 情 况 下 ,推荐 用 户 使 用 安装 过 АРТ 插件 的 Eclipse 来 开发 Android 应 用 程序 ， 
因为 目前 为 止 Eclipse 仍 是 较为 便捷 、 快 速 的 Android 开发 环境 。 在 Eclipse 和 Android 
SDK 正确 安装 后 ,就 可 以 下 载 并 安装 ADT 插件 了 。 

安装 АРТ 插件 有 两 种 方法 : 一 种 方法 是 手动 下 载 АРТ 插件 的 压缩 包 , 然 后 在 
Eclipse 中 进行 安装 ; 另 一 种 方法 是 在 Eclipse 中 输入 插件 的 下 载 地 址 ,由 Eclipse 自动 完 
成 下 载 和 安装 工作 。 这 两 种 方法 下 面 都 会 进行 介绍 ,推荐 使 用 第 一 种 方法 ,安装 成 功 的 
几率 很 高 ,而且 下 载 到 本 地 磁盘 的 ADT 插件 压缩 包 可 以 再 次 使 用 。 


1. 方法 一 ,手动 下 载 ADT 插件 


可 以 选择 从 Android 的 开发 者 网 站 中 进行 下 载 ,下 载 地 址 为 http://developer. 
android. com/sdk/installing/installing-adt. html, 打 开 后 如 图 2. 13 所 示 , 单 击 “ADT-23. 
0.4.zip” 即 可 开始 下 载 。 

下 载 ADT 插件 压缩 包 后 ,启动 Eclipse, 选 择 Help— Install New Software, 打开 
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Eclipse 的 插件 安装 界面 ,如 图 2. 14 所 示 。 


If you are still unable to use Eclipse to download the ADT plugin as a remote update site, you can download the ADT zip file 
to your local machine and manually install it: 


1. Download the ADT Plugin zip file (do not unpack it) 
Package Sze MD5 Checksum 
ADT-23.0.4.zip 103336810 bytes 91a43dcf686ab73dec2c08b77243492b 


. Start Eclipse, then select Help > Install New Software. 

Click Add, in the top-right corner. 

. In the Add Repository dialog, click Archive. 

Select the downloaded ADT-23.0.4.zip file and click OK. 

Enter "ADT Plugin' for the name and click OK. 

In the Available Software dialog, select the checkbox next to Developer Tools and click Next. 

. In the next window, you'll see a list of the tools to be downloaded. Click Next. 

Read and accept the license agreements, then click Finish. 

If you get a security warning saying that the authenticity or validity of the software can't be established, click OK. 
0. When the installation completes, restart Eclipse. 


юо зм о оь о № 


To update your plugin once you ve installed using the zip file, you will have to follow these steps again instead of the default 
update instructions. 


图 2.13 ADT 插 件 的 下 载 页 面 


Available Software 
Select a site or enter the location of a site. 


Work with ЕЕЕ = ава. 
Find more software by working with the "Available Software Sites" preferences. 


type filter text | 


Name 
[F1 QD There is no site selected. 


V] Show only the latest versions of available software [V Hide items that are already installed 
(V Group items by category What is already installed? 

Show only software applicable to target environment. 

Contact all update sites during install to find required software 


Q [ ШЕ [Frish 


图 2.14 Eclipse 的 插件 安装 界面 


在 单 击 Add 按钮 后 ,将 弹出 Add Repository 界面 。 单 击 Archive 按钮 ,选择 ADT Hfi 
件 压 缩 包 在 本 地 磁盘 中 的 位 置 .如 图 2. 15 тл 
在 ADT 插件 安装 前 ,会 提示 用 户 对 需要 安装 的 插件 进行 选择 和 确认 ,如 图 2. 16 所 
示 。 在 复 选 框 中 选中 Android DDMS, Android Development Tools, Android Hierarchy 
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Viewer 和 Android Traceview, 然 后 单 击 Next 按钮 进入 ADT 插件 许可 界面 。 


Name: 


Location: https://dl-ssl.google.com/android/eclipse/| 


@ 


2.15 Add Repository 界面 


Name Version 

4 [Z| 00 Developer Tools 
Ф Android DDMS 23.04.1468518 
Ф Android Development Tools 23.04.1468518 
Ф Android Hierarchy Viewer 23.04.1468518 
@ Android Native Development Tools 23.04.1468518 
Ф Android Traceview 23.04.1468518 
Ф Tracer for OpenGL ES 2304.1468518 


图 2.16 ADT 插 件 安装 选项 


最 后 ,还 需要 认可 一 些 开 源 软件 的 许可 协议 ,如 图 2. 17 所 示 , 只 要 选择 “I accept the 


terms of the license agreements” 即 可 。 


| © install = 


I 
Review Licenses 
Licenses must be reviewed and accepted before the software can be installed. 


> Apache License Apache License Р 
b Eclipse Foundation Software User Agreement Version 2.0, January 2004 а 
b Eclipse Public License - v 10 http /www.apache.org/ficenses/ 

> Note: jcommon-1.0.12 ar is under the BSD license rather than the APL. Yod TERMS AND CON E FONDSE REDUCTION; 

b Note: kxml2-2.3.0jar is under the BSD license rather than the EPL. You can| AND DISTRIBUTION 


1. Definitions. 

© 1 accept the terms of the license agreements 
| + | © 1 do not accept the terms of the license agreements 
@ [esse J net> (вана) Саке | 


图 2.17 ADT 插件 许可 界面 


整个 安装 过 程 会 持续 几 分 钟 ,安装 结束 后 会 出 现 Eclipse 重启 提示 ,选择 Restart 
Now 按钮 重新 启动 Eclipse, 使 ADT 插件 生效 。 


2. 方法 二 ,自动 下 载 ADT 插件 


Eclipse 自动 下 载 ADT 插件 的 方法 与 手动 方法 安装 相似 ,不 同 之 处 在 于 不 需要 到 网 
站 上 下 载 ADT 插件 压缩 包 ,而 直接 在 Add Repository 界面 中 输入 ADT 插件 的 下 载 地 
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址 即 可 ,如 图 2. 18 所 示 。 


Location: https;//dl-ssl.google.com/android/eclipse/| 


® Lec.) шсш 


2.18 自动 下 载 ADT 插件 


在 Location 栏 中 输入 https://dl-ssl. google. com/android/eclipse/ , 单 击 OK 按钮 
后 ,Eclipse 会 通过 网 络 自动 搜索 可 安装 的 插件 ,并 显示 如 图 2. 16 的 ADT 插件 安装 选项 
界面 ,之 后 的 安装 过 程 与 手动 下 载 ADT 插件 的 方法 完全 一 致 。 

在 ADT 插件 安装 完毕 后 ,进入 配置 Android 开发 环境 的 最 后 一 步 : 设置 Android 
SDK 的 保存 路 径 。 

重启 Eclipse 后 ,会 提示 找 不 到 SDK 目录 ,可 以 单 击 Open Preferences 进行 配置 。 也 
可 以 选择 Window 一 Preferences 打开 Eclipse 的 配置 界面 ,然后 单 击 左 侧 Android 以 打开 
Android 配置 界面 ,在 SDK Location 栏 中 输入 Android SDK 的 保存 路 径 ,最 后 单 击 
Apply 按钮 使 设置 生效 ,如 图 2. 19 所 示 。 


[type filter tet || Android 
b General PEER 
> Android 
b Ant SDK Location: DAAndroid SDK\android-sdk 
b С/С++ Note: The list of SDK Targets below is only reloaded once you hit Apply or 'OK'. 
b Code Recommenders 
› Help Vendor 
b Install/Update T Android Open Source Project 
b Java T Android Open Source Project 
b Maven Google Inc. 
> Мууп T Android Open Source Project 
> Run/Debug Google Inc. 
b Team T Android Open Source Project 

Validation В Android Open Source Project 

b WindowBuilder Google Inc. 
b XML 


图 2.19 Eclipse 配置 界面 
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22 Android Studio 开发 环境 


Android Studio 是 Google X Android 开发 者 准备 的 最 新 集成 开发 环境 ,基于 成 熟 
的 Intelli] IDEA ,集成 了 Android 的 开发 工具 和 调试 工具 。 除 了 Intellij 功能 以 外 ， 
Android Studio 还 提供 基于 Gradle 的 构建 支持 ,可 实时 预览 多 个 不 同 尺 寸 的 用 户 界 面 ， 
并 整合 了 Git 等 版 本 控制 系统 ,支持 更 智能 的 提示 补 全 功能 等 。 

Android Studio 已 经 被 Google 作为 官方 集成 开发 环境 ,目前 Android Studio 最 新 版 
本 为 v1.1.0。 

进行 Android Studio 安装 前 ,需要 提前 安装 Java Development Kit (JDK) 7 或 以 上 
版 本 ,之 后 可 以 选择 从 官方 网 站 下 载 , 网 址 为 http://developer. android. com/sdk/index. 
html, 这 里 提供 了 Android Studio 的 英文 基本 介绍 .特点 和 系统 要 求 等 ,如 图 2. 20 所 示 。 


А 


| droid 
uq 


X 


udio IDE 


Æ 2.20 Android Studio 官网 介绍 


也 可 以 选择 从 Android Studio 的 中 文 社 区 进行 下 载 , 这 里 除了 提供 安装 外 ,还 提供 
T Android Studio 的 中 文教 程 和 交流 论坛 ,网 址 为 http://www. android-studio. org/ 。 
单 击 右 上 角 下 载 集 成 了 Android SDK 的 版 本 ,如 图 2.21 所 示 。 


° 
Sfi jä IO Download Android Studio v1.0 
with the Android SDK for Windows | ( 813 WB ) 


中 文 组 下 载 专区 如 何 使 用 汉化 专题 有 问 有 答 DOWNLOAD ANDROIDSTUIO 中 文 社区 


ANDROID STUDIO V1.0 


246241434 bytes 6951e678a41b94b6172276727537db8590be7270 


245151810 bytes OdƏe0e230ece9f2e696b1b076c36eele73edcf3c 


243909934 bytes  601a302f10cf8422ba421660884a035bdfec38b3 


2.21 Android Studio 中 文 社 区 
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笔者 下 载 的 文件 名 为 android-studio-bundle-135. 1629389. exe. 直接 运行 安装 ,之 后 
会 提示 需要 安装 的 选项 ,建议 按 默认 选项 进行 安装 ,如 图 2.22 所 示 。 


Check Le components yor went to katal aad unchec rie componente yo dorit want to 
install. Click Next to continue. 


Select components to install: 


ET 
[V] Android SDK 

[v] Android Virtual Device 
[V] Performance (Intel® HAX| 


图 2.22 安装 选项 


由 于 安装 需要 的 硬盘 空间 较 大 ,笔者 将 Android Studio 安装 在 D 盘 ,将 SDK 也 安装 
在 同一 目录 中 ,如 图 2.23 所 示 。 


Android Studio Installation Location 


The location specified must have at least 500МВ of free space, 
Click Browse to customize: 


D: \Android\Android Studio 


Android SDK Installation Location 


Thie космо pe aant have st ienet 3-208 0f rea apace. 
Click Browse to 


mm 


图 2.23 安装 位 置 选择 


之 后 等 待 安装 完成 ,启动 Android Studio, 正 常 启动 会 出 现 如 图 2. 24 所 示 的 启动 画 
面 。 如 果 JDK 安装 或 环境 变量 配置 有 问题 则 会 提示 报错 。 

在 出 现 提示 对 话 框 后 ,选择 是 否 导 入 旧版 本 Android Studio 的 配置 。 因 为 是 初次 安 
装 , 所 以 直接 按 默认 的 选择 继续 ,如 图 2. 25 所 示 。 

如 果 Android Studio 的 启动 过 程 停止 在 如 图 2. 26 所 示 的 位 置 ,可 能 是 由 于 访问 官 
方 网 站 受阻 所 致 ,导致 因 无 法 获得 Android SDK 的 组 件 信 息 而 无 法 完成 启动 过 程 。 
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图 2.24 Android Studio 启动 界面 


fene UU ë 


You can import your settings from a previous version of Android Studio 


© E sant to import my settings from а custom location 


Specify config folder or installation home of the previous version of Android Studio 
| 


@) І do not have a previous version of Android Studio or I do not want to import my settings 


Cx] 


图 2.25 载 入 配置 文件 


Fetching Android SDK component information 


"Wssssssssssusssussussusssssssss) 


Powered by IntelliJ Platform 


2.26 获取 SDK 组 件 信息 


解决 方法 之 一 是 采用 “ 翻 墙 * 的 上 网 方式 。 另 一 种 方法 , 先 用 任务 管理 器 结束 掉 该 进 
程 ,之 后 找到 Android Studio 的 安装 目录 下 的 bin 目录 ,找到 名 为 idea. properties 的 文 
件 , 用 记事 本 打开 ,在 文件 末尾 添加 disable. android. first. run 王 true, 使 其 每 次 启动 不 用 
获取 更 新 。 之 后 重启 Android Studio, 由 于 是 第 一 次 启动 需要 较 长 的 一 段 准备 时 间 , 然 后 
才 可 以 进入 集成 开发 环境 ,如 图 2. 27 所 示 。 

至 此 ,Android Studio 开发 环境 就 安装 完成 了 。 后 面 的 内 容 会 对 Android SDK 的 目 
录 结 构 ,示例 程序 和 开发 工具 进行 介绍 。 
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2.27 Android Studio 集成 开发 环境 


23 Android SDK 


Android SDK 是 程序 开发 人 员 学 习 和 开发 Android 程序 的 宝贵 资源 ,不 仅 提 供 了 开 
发 所 必 备 的 调试 .打包 和 仿真 工具 ,还 提供 了 详尽 的 说 明文 档 和 简单 易 懂 的 开发 示例 。 


231 目录 结构 


在 Android SDK 安装 到 本 地 磁盘 后 ,可 以 在 文件 系统 中 查看 到 Android SDK 的 目 


录 结 构 , 如 图 2. 28 所 示 。 

其 中 ,add-one 目录 用 来 存放 Google 提供 
的 地 图 开发 包 , 该 地 图 开发 包 支 持 基 于 Google 
Map 的 地 图 开发 。docs 目录 下 的 是 Android 
SDK 的 帮助 文档 ,通过 目录 下 的 offline. html 
文件 启动 ,帮助 文档 的 首页 面 如 图 2. 29 Bros. 
extras\ google 目录 下 保存 了 Android 手机 的 
USB 驱动 程序 。platforms 目录 用 来 存放 SDK 
和 AVD 管理 器 下 载 的 各 种 版 本 的 SDK ,笔者 
的 目录 中 有 4. 0 版 本 的 SDK. platforms-tools 
目录 中 保存 了 与 平台 调试 相关 的 工具 ,如 adb, 
aapt 和 dx 等 。samples 目录 是 示例 代码 和 程序 
的 存放 目录 。temp 是 临时 存放 文件 的 目录 ,在 
SDK 和 AVD 管理 器 下 载 开 发 包 时 ,下 载 文件 


(+)add-ons 

(+)addon google apis google inc -21 
(*)build-tools 
(+)docs 
(+)extras 

(google 

(+)usb driver 

(+)platforms 

(+)android-14 
(+)platforms-tools 
(*)samples 

(+)android-14 
(+)sources 
(+)system-images 
(+)temp 
(tools 
(—)SDK Manager.exe 
(—)AVD Manager.exe 
(—)SDK Readme.txt 


图 2.28 Android SDK 的 目录 结构 
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会 临时 存放 在 这 个 目录 中 。tools 目录 保存 了 通用 的 Android 开发 调试 工具 和 Android 
手机 模拟 器 。SDK Manager. exe 和 АУР Manager. exe 分 别 是 SDK 和 АУР 的 管理 器 ， 
SDK Readme. txt 是 Android SDK 的 说 明文 档 。 
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2.29 Android SDK 帮助 文档 


Android SDK 帮助 文档 内 容 非常 丰富 ,详细 介绍 了 Android 系统 中 所 有 АРІ 函数 的 
使 用 方法 ,尤其 帮助 文档 中 的 开发 指南 (Dev Guide) ,系统 地 介绍 了 Android 应 用 程序 的 
开发 基础 ,用户 界面 .资源 使 用 .数据 存储 、 音 视频 功能 、 集 成 开发 环境 和 开发 工具 等 内 
容 , 对 于 学 习 Android 程序 开发 具有 指导 意义 。 


232 示例 程序 


TE — Android SDK >NsamplesNandroid-21 目录 中 ,有 多 个 基于 Android 5. 0. 1 版 本 
的 示例 程序 。 这 些 示 例 程序 多 数 并 不 复杂 ,但 可 以 从 不 同方 面 展 示 Android SDK 所 提供 
的 丰富 功能 。 


1. MultiResolution 示例 


MultiResolution Ж Android 程序 支持 不 同 尺 寸 屏 幕 的 示例 。 根 据 屏幕 解析 度 不 同 ， 
Android 程序 可 以 自动 加 载 不 同 大 小 的 图 片 , 避 免 图 片 尺 寸 对 界面 布局 产生 影响 。 
MultiResolution 示例 如 图 2. 30 所 示 。 


2. ApiDemos 示例 


ApiDemos 示例 提供 了 Android 平台 上 多 数 API 的 使 用 方法 ,涉及 系统 .资源 .图形 、 
搜索 .语音 识别 和 用 户 界面 等 方面 。 程 序 开 发 人 员 可 以 在 Android 应 用 程序 开发 过 程 中 
参考 ApiDemos 示例 ,但 该 示例 的 代码 文件 众多 ,结构 上 略 显 混乱 。ApiDemos 示例 如 
图 2.31 所 示 。 


图 2.30  MultiResolution 示例 图 2.31  ApiDemos 示例 


3. SkeletonApp 示例 
SkeletonA pp 示例 是 一 个 界面 演示 程序 ,说 明了 如 何 使 用 布局 和 界面 控件 设计 用 户 
界面 ,以 及 如 何在 界面 中 添加 菜单 和 处 理 菜单 事件 。SkeletonApp 示例 如 图 2. 32 所 示 。 


4. NotesPad 示例 

NotesPad 示例 是 一 个 记事 本 程序 ,可 以 将 文字 内 容 保存 在 记事 本 程序 中 ,并 支持 添 
加 和 删除 记事 本 操作 。NotesPad 示例 说 明了 如 何 进 行 复 杂 程 序 设 计 , 以 及 如 何 使 用 
SQLite 数据 库 保存 数据 ,如 何 使 用 ContentProvider 共享 数据 。NotesPad 示例 如 图 2. 33 


所 示 。 


E New note 


Test 123 


e. you Activity! 


2.32 SkeletonApp 示例 E] 2.33  NotesPad 示例 


5. Home 示例 

Home 示例 是 一 个 桌面 主题 程序 ,可 以 将 自 定义 的 桌面 主题 注册 到 系统 中 ,用 户 可 以 
通过 点 击 HOME 键 选择 不 同 的 桌面 主题 。 此 示例 说 明了 如 何 进行 桌面 主题 程序 的 开 
发 ,以 及 在 开发 过 程 中 需要 注意 的 事项 。Home 示例 如 图 2. 34 所 示 。 
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6. Snake 示例 

“ 贪 吃 蛇 ? 程 序 , 即 Snake 示例 是 一 个 经 典 的 小 游戏 ,可 以 通过 导航 键 控制 贪 吃 蛇 的 
前 进 方向 。 该 示例 演示 了 如 何在 Android 系统 中 进行 游戏 开发 ,对 进行 游戏 开发 的 程序 
人 员 具 有 一 定 的 参考 价值 。Snake 示例 如 图 2. 35 所 示 。 
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2.34 Home 示例 2.35 Snake 示例 


7. LunarLander 示例 
LunarLander 示例 也 是 一 个 小 游戏 ,模拟 登陆 舱 在 月 球 表面 着 陆 。 用 户 通过 


陆 舱 的 方向 和 速度 ,使 登陆 舱 可 以 平稳 地 在 月 球 表面 着 陆 。LunarLander 示例 实现 了 
单 的 碰撞 检查 功能 ,值得 游戏 开发 人 员 学 习 和 参考 。LunarLander 示例 如 图 2. 36 所 示 。 


8. JetBoy 示例 


JetBoy 示例 是 一 个 支持 背景 音乐 和 音效 的 游戏 程序 ,用 户 可 以 控制 飞船 击 碎 飞 来 的 
陨石 。JetBoy 示例 如 图 2.37 所 示 。 


TBOoy 


JET audio-engine demo 


Р 2.36  LunarLander 示例 2.37 JetBoy 示例 
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233 开发 工具 


Android SDK 提供 了 多 个 强大 的 开发 工具 .便于 程序 开发 人 员 简 化 开发 和 调试 过 
程 。 这 些 工具 中 多 数 可 以 在 Eclipse 中 直接 调用 ,也 有 部 分 是 需要 在 命令 行 模式 下 使 用 
的 ,后 面 将 逐个 介绍 这 些 工 具 。 


1. Android 模拟 器 


Android SDK 中 最 重要 的 工具 就 是 Android 模拟 器 ,如 图 2. 38 所 示 。 它 允许 程序 
开发 者 在 没有 物理 设备 的 情况 ,在 计算 机 上 对 Android 程 i . 
序 进行 开发 .调试 和 仿真 。 

Android 模拟 器 可 以 仿真 手机 的 绝 大 部 分 硬件 和 软件 
功能 ,支持 加 载 SD 卡 映像 文件 ,更 改 模拟 网 络 状态 .延迟 
和 速度 ,模拟 电话 呼叫 和 接收 短信 等 ,支持 将 屏幕 当成 触 
摸 屏 使 用 ,可 以 使 用 鼠标 点 击 屏幕 模拟 用 户 对 Android 设 
备 的 触摸 操纵 。 在 Android 模拟 器 上 有 普通 手机 常见 的 
各 种 按键 ,如 音量 键 、 挂 断 键 .返回 键 和 菜单 键 等 。 但 目前 
为 止 ,Android 模拟 器 仍 不 支持 的 功能 包括 接听 真实 电话 
呼叫 .USB 链接 、 摄 像 头 捕获 .连接 状态 检测 .电池 电量 、 
AC 电源 检测 SD 卡 插 拔 检查 和 蓝牙 设备 等 。 2.38 Android 模拟 器 

Android 模拟 器 还 支持 多 种 屏幕 解析 度 和 不 同 的 外 
Ж.Ж 2.1 列举 了 Android SDK 4. 0 版 本 所 支持 的 屏幕 解析 度 。 

表 2.1 Android 模拟 器 外 观 


类 型 解 析 m 说 明 
QVGA 240х320 低 解析 度 ,小 屏幕 
WQVGA400 240X 400 低 解 析 度 ,中 屏幕 
WQVGA432 240X432 低 解 析 度 ,中 屏幕 
HVGA 320X480 中 等 解析 度 ,中 屏幕 
WVGA800 480X 800 高 解析 度 ,中 屏幕 
WVGA854 480 Х 854 高 解析 度 ,中 屏幕 
WVGA720 1280 x 720 较 高 解析 度 ,中 屏幕 
WSVGA 1024 X 600 中 等 解析 度 ,大 屏幕 
WXGA 1280 X 800 中 等 解析 度 ,大 屏幕 


2. Android 调试 桥 


Android 调试 桥 (Android Debug Bridge.ADB) 是 用 于 连接 Android 设备 或 模拟 器 的 
工具 ,负责 将 应 用 程序 安装 到 模拟 器 和 设备 中 ,或 从 模拟 器 或 设备 中 传输 文件 。Android 
调试 桥 是 一 个 客户 端 / 服 务 器 程序 ,包含 守护 程序 .服务 器 程序 和 客户 端 程序 。 守 护 程序 
运行 在 每 个 模拟 器 的 后 台 ; 服 务 器 程序 运行 在 开发 环境 中 ,管理 客户 端 和 守护 程序 的 连 
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接 ; 客 户 端 程序 通过 服务 器 程序 ,与 模拟 器 中 的 守护 程序 相连 接 。 


3. DDMS 


DDMS(Dalvik Debug Monitor Service) J& Android 系统 中 内 置 的 调试 工具 ,可 以 用 


来 监视 Android 系统 中 进程 .堆栈 信息 ,查看 
志 , 实 现 端口 转发 服务 和 屏幕 截图 功 
能 .模拟 器 电话 呼叫 和 SMS 短信 ,以 及 浏览 
Android 模拟 器 文件 系统 等 。DDMS 的 启动 文 
件 是 二 Android SDK /tools/ddms. bat, 

在 Eclipse 中 , 可 通过 Window — Open 
Perspective-* Other DDMS 打开 DDMS 调试 
界面 ,然后 通过 Window-—Show view—Other 1T 
JF Show View 的 选择 对 话 框 ,如 图 2. 39 所 示 。 
这 样 就 可 以 在 DDMS 调试 界面 中 添加 任何 希望 


logcat 


b @ Code Recommenders 
» @ CVs 

b © Debug 

b © Git 

> @> Help 

b © Java 


b 25 Java Browsing 
» @ Make 


b © Maven 


进行 调试 和 检查 的 功能 。 [mtem 

DDMS 中 的 设备 管理 器 (Devices) ,可 以 同 [| 
时 监控 多 个 Android 模拟 器 ,显示 每 个 模拟 器 中 
正在 运行 的 所 有 进程 。 模 拟 器 使 用 端口 号 进行 
唯一 标识 ,例如 监听 端口 是 5554 的 模拟 器 则 标 
识 为 emulator-5554。 在 选择 指定 的 进程 后 ,可 
以 通过 右上 角 的 按钮 刷新 进程 中 线程 和 堆栈 的 信息 ,或 点 击 STOP 按钮 关闭 指定 进程 。 
另外 ,这 里 还 提供 屏幕 截图 功能 ,可 以 将 Android 模拟 器 当前 的 屏幕 内 容 保 存 成 png Ж 
fF. DDMS 中 的 设备 管理 器 如 图 2. 40 所 示 。 


2.39 Show View 选择 对 话 框 


| E Devices 22 | leasg olele еп 
Name 
4 Ë] emulator-5554 Online Nexus 4 API 21 [5.0, debug] 
[ system process 347 8600 / 8700 
com.android.server.telecom 630 8624 
com.android.launcher 648 8626 
com.android.phone 636 8629 
com.android.printspooler 789 8630 
com.android.externalstorage 811 8631 
com.android.systemui 918 8615 
android.process.acore 977 8614 
com.android.inputmethod.latin 996 8622 
android.process.media 1013 8628 
com.android.deskclock 1038 8632 
com.android.music 1063 8633 
com.android.keychain 1086 8634 


2.40 DDMS 中 的 设备 管理 器 


DDMS 中 的 模拟 器 控制 器 (Emulator Control) ,可 以 控制 Android 模拟 器 的 网 络 速 
度 和 延迟 ,模拟 语音 和 SMS 短信 通信 。 模 拟 器 控制 支持 的 网 络 速率 包括 GSM, HSCSD, 
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PRS.EDGE.MTS.DPA 和 全 速率 ,支持 的 网 络 延 迟 有 GPRS, EDGE, UMTS 和 无 延迟 。 
DDMS 中 的 模拟 器 控制 器 如 图 2. 41 所 示 。 


Š, Threads 


Ө Heap Ü Allocation Tracker “P Network Statistic: Explorer Qj Emulator Control 21 M s: 


Telephony Status 


Voice: home М Speed: Full ` 
Data: home v Latency: None v 
Telephony Actions 


Incoming number: 
° voice 


SMS 


Call Hang Up 
Location Controls. 
Manual GPX |KML 


@ Decimal 


O Sexagesimal 


Longitude | -122.084095 


2.41 DDMS 中 的 模拟 器 控制 器 


在 Telephony Actions 中 的 Incoming number 中 输入 打 入 的 电话 号 码 , 然 后 选择 语 
言 呼叫 (Voice) 点 击 Send 按钮 后 ,模拟 器 就 可 以 接收 到 来 自 输 入 电话 号 码 的 语音 电话 ， 
如 图 2. 42( 左 ) 所 示 。 如 果 选 择 短信 (SMS) ,在 Message 中 填 入 短信 的 内 容 , 模 拟 器 就 可 
以 接收 来 自 输入 电话 号 码 的 SMS 短信 ,如 图 2.42( 右 ) 所 示 。 


E PTT 


1 360-000-1111 


图 2.42 Android 电话 呼 入 和 SMS 短信 


DDMS 中 的 文件 浏览 器 (File Explorer) ,可 以 对 Android 内 置 存储 器 上 的 文件 进行 
上 传 .下 载 和 删除 等 操作 ,还 可 以 显示 文件 和 目录 的 名 称 、 权 限 、 建 立时 间 等 信息 。DDMS 
中 的 文件 浏览 器 如 图 2.43 所 示 。 


DDMS 中 的 日 志 浏 览 器 (LogCat) ,可 以 浏览 Android 系统 、Dalvik 虚拟 机 或 应 用 程 


序 产生 的 日 志 信 息 , 有 助 于 快速 定位 应 用 程序 产生 的 错误 。DDMS 中 的 日 志 浏 览 器 如 
图 2.44 所 示 。 


除了 上 面 介 绍 的 功能 外 ,DDMS 还 能 够 查看 虚拟 机 的 堆栈 状态 、 线 程 信息 和 控制 台 
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Mos isis (узж) 


($ Threads Heap Ü Allocation Tracker “P Network Statistics (File Explorer 7; QÑ Emulator Control [7 System Information 


Name 

> @ аса 

> © cache 
B charger 


b Ф data 


> Ф dev 


B initzygote3: 
S mnt 
@ proc 
È property сс 


Size Date 

2015-02-01 
2015-02-01 
1970-01-01 
2015-02-01 
2015-02-01 
2015-02-01 
1970-01-01 
2015-02-01 
2015-02-01 
1970-01-01 
1970-01-01 
1970-01-01 
1970-01-01 
1970-01-01 
1970-01-01 
1970-01-01 
1970-01-01 
1970-01-01 
2015-02-01 
2015-02-01 
2614 1970-01-01 


Time 


09:46 


281 


10771 
382 
600228 
981 
22431 
1927 
3885 
2642 
301 


dr-xr-xr-x 


-wr 


Permissions Info 


-> [sbin/he... 


-> /sys/ker.. 


-> /system... 


2.43 DDMS 中 的 文件 浏览 器 


жыз] и аз 


2.44 DDMS 中 的 日 志 浏 览 器 


信息 。 由 此 可 见 ,DDMS 是 进程 程序 调试 和 错误 定位 的 强大 工具 。 


4. 其 他 工具 


为 了 便于 Android 程序 开发 .Android SDK 还 提供 了 一 些小 工具 。 这 些 工 具 的 名 
称 、 用 途 和 启动 文件 参见 表 2.2. 


表 2.2 Android SDK 提供 的 其 他 工具 


工具 名 称 启动 文件 说 明 
数据 库 工 具 sqlite3. exe 用 来 创建 和 管理 SQLite 数据 库 
打包 工具 apkbuilder. bat 将 应 用 程序 打包 成 . apk 文件 
层级 观察 器 hierarchyviewer. bat ИЕ 
2. Р 以 图 形 化 的 方式 显示 应 用 程序 的 执行 日 志 , 用 来 
跟踪 显示 工具 traceview. bat 调试 应 用 程序 ,分 析 执行 效率 
SD 卡 映像 创建 工具 mksdcard. exe 建立 SD 卡 的 映像 文件 


工具 名 称 


启动 文件 
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续 表 
й 明 


NinePatch 文件 编辑 
工具 


draw9patch. bat 


NinePatch 是 Android 提供 的 可 伸缩 的 图 形 文件 
格式 ,基于 PNG 文件 。draw9patch 工具 可 以 使 
用 WYSIWYG 编辑 器 建立 NinePatch 文件 


经 过 zipalign 优化 过 的 APK 程序 ,Android 系统 
可 更 高 效 的 根据 请 求索 引 APK 文件 中 的 资源 。 


APR ERMITA. | ipsa cir 使 用 4 字 节 的 边界 对 齐 方式 米 影射 内 存 ,通过 空 
间 换 时 间 的 方式 提高 执行 效率 
deus | asss Ba ТЕТЕ УТГА 


字段 和 方法 名 称 ,使 代码 较 难 实施 逆向 工程 


PNG 和 ETC1 转换 
工具 


etcltool. exe 


命令 行 工 具 , 支 持 将 PNG 和 ETCI 相互 转换 


Monkey 可 在 模拟 器 或 设备 上 产生 随机 操作 事 


界面 操作 测试 工具 Monkey( 通 过 adb 运行 ) | 件 ,包括 点 击 、 触 摸 或 手势 等 ,用 于 对 程序 的 用 户 
界面 进行 随机 操作 测试 
模拟 器 控制 工具 monkeyrunner. bat 允许 通过 代码 或 命令 ,在 外 部 控制 模拟 器 或 设备 


= 
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1. 尝试 安装 Android 开发 环境 ,并 记录 安装 和 配置 过 程 中 所 遇 到 的 问题 。 
2. 浏览 Android SDK 帮助 文档 ,了 解 Android SDK 帮助 文档 的 结构 和 用 途 。 


3. 在 Android SDK 中 ,Android B1 2$ , Android ii iX Er fl DDMS 是 Android 应 用 


程序 开发 过 程 中 经 常 使 用 的 工具 , 简 述 这 三 个 工具 的 用 途 。 


第 一 个 Android 程序 


本 章 主要 介绍 开发 Android 应 用 程序 的 基础 知识 和 基本 方法 。 通 过 本 章 内 容 的 学 
习 , 读 者 可 以 掌握 使 用 Eclipse 和 Android Studio 开发 Android 应 用 程序 的 过 程 和 方法 ， 
T f Android 应 用 程序 的 目录 结构 和 自动 生成 文件 的 作用 。 学 习 如 何 使 用 命令 行 创 建 
Android 应 用 程序 ,有 助 于 深入 理解 Android 程序 的 生成 .安装 和 运行 过 程 。 

本 章 学 习 目 标 : 

。 掌握 使 用 Eclipse 开发 Android 应 用 程序 的 方法 ; 

。 掌握 Android 虚拟 设备 (AVD) 的 创建 方法 ; 

° ҮЙ R.java 文件 的 用 途 和 生成 方法 ; 

* 7# AndroidManifest. xml 文件 的 用 途 ; 

* 了 解 Android 的 程序 结构 ; 

* 了 解 使 用 Android Studio 开发 Android 应 用 程序 的 方法 ; 

° 了 解 使 用 命令 行 创建 Android 程序 方法 。 


34 Edipse 创建 应 用 程序 


本 节 将 介绍 如 何 使 用 Eclipse 集成 开发 环境 建立 第 一 个 Android 程序 
HelloAndroid。 首 先 启动 Eclipse, 显 示 的 集成 开发 环境 如 图 3. 1 所 示 。 如 果 在 Eclipse 
中 建立 过 Android 工程 ,工程 名 称 和 目录 结构 将 显示 在 Package Explorer 区 域内 。 

有 两 种 方法 可 以 打开 Android 工程 向 导 , 一 种 是 通过 File New — Project + | 
Android Android Project 打开 , 另 一 种 是 通过 File— New == Other + | Android > 
Android Project 打开 。 两 种 方法 只 是 选择 的 顺序 不 同 ,结果 是 相同 的 。 在 第 二 种 方法 
中 ,除了 可 以 建立 Android 工程 向 导 外 ,还 可 以 建立 Android 示例 工程 ,就 是 保存 在 
<Android SDK /samples 目录 中 的 示例 。 如 图 3. 2 所 示 , 选 择 Android Project 建立 
Android 工程 。 

第 一 步 ,首先 需要 填写 应 用 程序 名 称 (Application Name) 与 工程 名 称 (Project 
Name) 。 工 程 名 称 默 认 与 应 用 名 称 一 致 ,Eclipse 会 自动 将 应 用 程序 名 称 填写 在 工程 名 称 
这 一 栏 中 ,用 户 可 以 不 用 更 改 , 使 用 这 个 推荐 设置 。 需 要 注意 的 是 ,工程 名 称 必 须 唯 一 ， 
不 能 与 已 有 的 工程 名 称 重复 。 应 用 程序 名 称 是 Android 程序 在 手机 或 模拟 器 中 显示 的 
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图 3.1 Eclipse 集成 开发 环境 


© New Project =) = 
Select a wizard =? | 
Create ап Android Application project | 


Wizards: 
type filter text 


L 


b © General a 
4 © Android 
(Q3 Android Application Project. 
(Ë Android Project from Existing Code 
名 Android Sample Project 
JÊ Android Test Project 
b g С/С++ 
> ё CVs 
> © Java 
b © Maven zi 


@ [s e s= inis 


图 3.2 Eclipse 工程 向 导 


名 称 , 程 序 运 行 时 也 会 显示 在 屏幕 顶部 。 这 里 填 人 HelloAndroid 作为 工程 名 称 , 如 
图 3.3 所 示 。 

包 名 称 (Package Name) 是 包 的 命名 空间 ,需要 遵循 Java 包 的 命名 方法 。 包 名 称 由 
两 个 或 多 个 标识 符 组 成 ,中 间 用 点 隔 开 , 例 如 edu. hrbeu. HelloAndroid。 使 用 包 主 要 为 
了 避免 命名 冲突 ,因此 可 以 使 用 反 写 电子 邮件 地 址 的 方式 保证 命名 的 唯一 性 ,例如 笔者 
电子 邮件 地 址 是 wangxianghui@hrbeu. edu. cn, 则 可 以 将 包 名 称 命名 为 cn. edu. hrbeu. 


TELET sn) 


Creates a new Android Application 


Application Name: HelloAndroid 
Project Name: HelloAndroid 
Package Name:0 edu.hrbeu.helloandroid 


Minimum Required SDK:0 АР1 15: Android 4.0.3 (IceCreamSandwich) 
Target SDK:0| API 21: Android 4.X (L Preview) ` 
Compile With:o[API 21: Android 4X (L Preview) 
Theme:0[Holo Light with Dark Action Bar 


9 Choose the lowest version of Android that your application will support. Lower API levels target 
more devices, but means fewer features are available. By targeting API 8 and later, you reach 
approximately 95% of the market. 


图 3.3 Android 工程 向 导 


wangxianghui。 为 了 保证 代码 的 简洁 ,第 一 个 Android 程序 的 包 名 称 使 用 edu. hrbeu. 
helloandroid 。 

SDK 最 低 版 本 (Minimum SDK) 指 的 是 Android 程序 能 够 运行 的 最 低 АРІ 等 级 ,如 
果 手 机 中 的 Android 系统 的 API 等 级 低 于 程序 的 SDK 最 低 版 本 , 则 程序 不 能 够 在 该 
Android 系统 中 和 运行。 选择 低 版 本 的 API 可 以 提高 程序 的 兼容 性 ,但 是 由 于 为 了 兼容 低 
版 本 API, 在 工程 中 就 无 法 使 用 新 版 本 API 中 加 入 的 新 功能 。 为 此 ,笔者 一 般 选 择 使 用 
API15, 可 以 在 兼容 绝 大 部 分 手机 的 情况 下 ,使 用 一 些 流 行 的 新 功能 。 

API 等 级 是 Android 系统 中 用 来 标识 API 框 架 版 本 的 一 个 整数 ,用 来 识别 Android 
程序 的 可 运行 性 。 如 果 Android 程序 标识 的 API 等 级 高 于 Android 系统 所 支持 的 API 
等 级 ,程序 则 无 法 在 该 Android 系统 中 运行 。API 等 级 与 系统 版 本 之 间 的 对 照 关系 可 参 
Ad 3.1. 


表 3.1 API 等 级 对 照 表 


系统 版 本 API 等 级 版 本 代号 支持 设备 类 型 
Android 5. 0. 1 21 Lollipop ied 
Android 4. 4W 20 KitKat Wear 可 穿戴 设备 
Android 4.4 19 KitKat е 
Android 4.3 18 Jelly Bean — 
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续 表 
系统 版 本 API 等 级 版 本 代号 支持 设备 类 型 
Android 4.2 17 Jelly Bean ны 
Android 4.1 16 Jelly Bean ale ia 
Android 4. 0. 3-4. 0. 4 15 Ice Cream Sandwich bebe 
Android 4. 0 14 Ice Cream Sandwich ibn 
Android 3. 2 13 HONEYCOMB MR2 平板 电脑 
Android 3. 1. x 12 HONEYCOMB_MR1 平板 电脑 
Android 3. 0. x 11 HONEYCOMB 平板 电脑 
Android 2. 3. 4 
0 GING M 2 

о 1 INGERBREAD МКІ 智能 手机 
Android 2.3.2 

Android 2. 3.1 9 GINGERBREAD 智能 手机 
Android 2.3 

Android 2. 2. x 8 FROYO 智能 手机 
Android 2. 1. x 7 ECLAIR MRI 智能 手机 
Android 2.0.1 6 ECLAIR_0_1 智能 手机 
Android 2.0 B ECLAIR 智能 手机 
Android 1.6 4 DONUT 智能 手机 
Android 1.5 3 CUPCAKE 智能 手机 
Android 1.1 2 BASE 11 智能 手机 
Android 1.0 1 BASE 智能 手机 


第 二 步 ,选择 创建 工程 位 置 ,新建 的 工程 被 保存 在 默认 的 工作 空间 中 ,笔者 的 工作 空 
间 是 D:/workplace,; 所 以 将 HelloAndroid 工程 保存 在 D: /workplace/ HelloAndroid Н 
录 中 。 当 然 , 也 可 以 取消 Creat Project in Workspace 的 复 选 框 , 选 择 其 他 位 置 保 存 
Android 工程 。 

创建 Activity(Create Activity) 是 一 个 可 选项 ,如 果 需 要 自动 生成 一 个 Activity 的 代 
码 文件 , 则 需要 选择 该 项 ,否则 可 以 不 选 。Activity 主要 用 于 管理 用 户 界面 ,后 续 章 节 会 
做 详细 介绍 ,这 里 选择 该 项 ,如 图 3.4 所 示 。 

在 如 图 3.5 所 示 的 界面 ,可 以 选择 页 面 模板 ,使 用 一 些 常 用 的 模板 可 以 节省 开发 时 
间 ,一 般 选 择 创建 空白 页 面 模板 (Blank Activity) 即 可 。 

在 如 图 3.6 所 示 的 界面 中 ,可 以 更 改 Activity 以 及 对 应 布局 文件 Layout 的 名 称 , 一 
般 选 择 默认 名 称 即 可 。 
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[E Mark this project as a library 


(V) Create Project in Workspace. 
Location: [DAworkplaceHelloAndroid 


Working sets 
E Add project to working sets 


Working sets: 


Blank Activity with Fragment 


Fullscreen Activity 
Master/Detail Flow 
Navigation Drawer Activity 
Tabbed Activity 


Blank Activity 
Creates a new blank activity with an action bar. 


ева | 


图 3.5 选择 页 面 模板 
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Creates а new blank activity with an action bar. 


Activity Матео MainActivity 
Layout Name? activity main 


О The name of the activity class to create 


图 3.6 重 命名 Activity 


最 后 单 击 Finish 按钮 ,工程 向 导 会 根据 用 户 所 填写 的 Android 工程 信息 ,自动 在 后 
台 创建 Android 工程 所 需要 的 基础 文件 和 目录 结构 。 当 创建 过 程 结束 ,用 户 将 看 到 图 3. 7 


所 显示 的 内 容 。 


с-та ві 
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3.7 HelloAndroid 工程 的 文件 和 目录 结构 


用 户 无 须 在 HelloAndroid 工程 中 添加 任何 代码 , 即 可 运行 HelloAndroid 程序 。 但 
为 了 让 Android 程序 能 够 正常 运行 ,必须 首先 建立 Android 虚拟 设备 (Android Virtual 
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Device, AVD). 

AVD 是 对 Android 模拟 器 进行 自 定 义 的 配置 清单 ,能 够 配置 Android 模拟 器 的 硬 
件 列表 、 模 拟 器 的 外 观 、 支 持 的 Android 系统 版 本 、 支 持 的 附件 SDK 库 和 存储 设置 等 信 
息 。 在 用 户 配置 好 АУР 后 ,Eclipse 就 可 以 按照 用 户 的 要 求 启动 特定 版 本 和 硬件 特征 的 
Android 模拟 器 。 配 置 AVD 最 简单 的 方式 是 通过 Eclipse 的 Window— AVD Manager 
启动 AVD 管理 器 ,如 图 3. 8 所 示 。 


Android Virtual Devices | Device Definitions 


List of existing Android Virtual Devices located at C:\Users\ice\.android\avd 
AVD Name Target Name Platfo... АРІ Le.. CPU/ABI 
Z No AVD available = 一 


| Delete... 


[Detaits.. ] 


Refresh 
Á A repairable Android Virtual Device. XX An Android Virtual Device that failed to load. Click 'Details' to see tl 


图 3.8 AVD 管理 器 


在 AVD 管理 器 单 击 Creat, 打 开 AVD 创建 界面 ,如 图 3. 9 所 示 。 用 户 需 要 在 АУР 
Name 栏 中 输入 AVD 的 名 称 。 为 了 便于 区 分 多 个 АУР 的 用 途 ,一般 在 АУР 命名 时 会 
体现 Android 的 版 本 信息 。 此 处 建立 名 为 “Android 5. 0. 1" fJ AVD, 注 意 不 要 有 空格 。 
Device 表示 常见 设备 列表 ,其 中 包括 一 些 常用 的 手机 信息 ,如 手机 屏幕 尺寸 与 分 辨 率 大 
小 等 ,选择 其 中 一 项 以 后 ,可 以 自动 配置 下 面 的 Memory Options 内 存 设置 、Internal 
Storage 内 部 存储 空间 等 参数 ,也 可 以 根据 自己 需要 进行 修改 。Target 是 AVD 支持 的 
Android 系统 ,这 里 选择 “Android 5. 0. 1-API Level 21”, CPU/ABI 表示 虚拟 机 使 用 的 
CPU 类 型 ,如果 这 里 没有 选项 ,查看 SDK Manager 中 该 API 对 应 的 CPU image 文件 是 
fi FAX. SD Card 中 输入 128 ,表示 在 模拟 器 中 将 模拟 一 个 大 小 为 128M 的 SDF. Skin 
表示 模拟 器 的 外 观 , 选 择 Skin with dynamic hardware controls 即 可 。Keyboard 表示 是 
否 提 供 虚拟 按键 ,Front Camera 和 Back Camera 分 别 表示 前 置 摄像 头 与 后 置 摄像 头 , 在 
没有 特别 要 求 的 情况 下 ,可 以 使 用 默认 的 设置 。 完 成 AVD 的 配置 后 ,点 击 OK 按钮 保存 
AVD 的 配置 信息 ,然后 在 АУР 管理 器 中 单 击 Start 按钮 启动 Android 模拟 器 。 

在 启动 Android 模拟 器 前 ,用 户 还 需 在 Launch Options 界面 中 确认 启动 项 ,包括 将 
显示 尺寸 缩放 到 实际 屏幕 尺寸 和 删除 模拟 器 中 原 有 数据 ,以 及 从 快照 点 启动 和 存储 快照 
等 。Launch Options 的 界面 如 图 3. 10 所 示 。 
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Android5.0.1 


Nexus 4 (4.7" 768 x 1280: xhdpi) 


Android 5.0.1 - API Level 21 


CPU/ABI: ARM (armeabi-v7a) 


Keyboard: (V Hardware keyboard present 


Skin: 


Front Camera: 


Back Camera: 


Memory Options: VM Heap: 64 


Internal Storage: MB.» | 


SD Card: 


Browse... 


图 3.9 АУР 创建 界面 


Skin: 768x1280 
Density: 320 
Peale display to real sid 


Screen Size (in): | 4.7 | 


Monitor dpi: [96 


Scale: default 


| E Wipe user data 
| [ ]Launch from snapshot 


| [ Save to snapshot 


mm 


3.10 Launch Options 界面 


使 用 Eclipse 运行 Android 程序 非常 简单 ,只 要 从 Run Run | Android Application 


яў Run— Debug | Android Application 便 可 运行 Android 程序 。 启 动 Android 模拟 器 是 


一 个 缓慢 的 过 程 ,程序 调试 完毕 后 ,不 必 关 闭 Android 
模拟 器 ,可 以 节约 下 次 程序 调试 时 启动 模拟 器 的 时 间 。 
Eclipse 会 自动 完成 Android 程序 编译 ,打包 和 上 传 等 
过 程 ,并 将 程序 的 运行 结果 显示 在 模拟 器 中 。 
HelloAndroid 程序 的 运行 结果 如 图 З. 11 所 示 。 

可 以 通过 Run — Run Configuration 或 Run 一 
Debug Configuration 配置 模拟 器 的 运行 选项 。 图 3. 12 
显示 Run Configuration 的 运行 选项 ,从 中 能 够 选择 不 
同 的 AVD、 配 置 网 络 速度 、 网 络 延 迟 、 控 制 台 的 字符 编 
码 和 标准 输入 输出 等 内 容 。 一 般 情况 下 ,只 要 正确 选择 
AVD 即 可 ,其 他 选项 可 以 不 做 任何 修改 。 

至 此 已 使 用 Eclipse 创建 了 第 一 个 Android 程序 ， 


并 得 到 了 程序 的 运行 结果 ,对 如 何 建立 和 运行 Android 程序 已 经 有 了 基本 的 了 解 。 后 面 
的 内 容 仍 然 以 HelloAndroid 为 例 , 介 绍 Eclipse 创建 的 Android 的 程序 目录 结构 和 文件 


Hello мона 


3.11 HelloAndroid 的 运行 结果 
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Create, manage, and гип configurations 
Android Application @ | 
D @ x| e 2 - Name: HelloAndroid | 
| | || (El Android™ (Ë Target] Т1 соттоп) 
4 回 Android Application ç 
回 HelloAndroid 
f£] SQUteDemo HelloAndroid rem 
Ji Android JUnit Test Lundi Абон 
[E] C/C++ Application © Launch Default Activi 
Java Applet n z 
[7] Java Application © leund 
Ju JUnit © Do Nothing 
> Launch Group 
та Maven Build 
Ју Task Context Test 
Filter matched 11 of 12 items _ App |[ Ree ] 
© Све) = 


图 3.12 启动 选项 


32 Android 程序 结构 


在 建立 HelloAndroid 程序 的 过 程 中 ,ADT 会 自动 建立 一 些 目 录 和 文件 ,如 图 3. 13 
所 示 。 这 些 目 录 和 文件 有 其 固定 的 作用 ,有 的 允许 修改 ,有 的 则 不 能 进行 修改 ,了 解 这 些 
文件 和 目录 对 Android 程序 开发 有 着 非常 重要 的 作用 。 

在 Package Explore 中 ,ADT 以 工程 名 称 Hello Android 作为 根 目 录 , 将 所 有 自动 生 
成 的 和 非 自 动 生 成 的 文件 都 保存 在 这 个 根 目录 下 。 根 目录 下 包含 5 个 子 目录 src、gen、 
assets、bin 和 res, 两 个 的 库 文件 android. jar、android-support-v4. jar 以 及 3 个 工程 文件 
Androidmanifest. xml, project. properties 和 proguard. cfg. 

src 目录 是 源 代码 目录 ,所 有 人 允许 用 户 修改 的 java 文件 和 用 户 自己 添加 的 java 文件 
都 保存 在 这 个 目录 中 。HelloAndroid 工程 建立 初期 ,ADT 根据 用 户 在 工程 向 导 中 选择 
的 Create Activity 选项 ,自动 建立 HelloAndroid. java 文件 。 

gen 目录 用 来 保存 ADT 自动 生成 的 java 文件 ,例如 К. java 或 AIDL 文件 。 这 个 目 
录 中 的 文件 不 建议 用 户 进行 任何 修改 ,如 果 用 户 删除 该 目录 中 的 文件 ,ADT 会 自动 再 次 
生成 被 删除 的 文件 。 

assets 目录 用 来 存放 原始 格式 的 文件 ,例如 音频 文件 .视频 文件 等 二 进 制 格式 文件 。 
此 目录 中 的 资源 不 能 够 被 R. java 文件 索引 ,因此 只 能 以 字 节 流 的 形式 进行 读 取 。 默 认为 
空 目录 。 
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[š Package Explorer 5: ] SESA d 


4 @ HelloAndroid 


4 (9 src 
4 8 edu.hrbeu.helloandroid 


4 © drawable-hdpi 
Ri ic. launcher.png 
© drawable-ldpi 
» @> drawable-mdpi 
> £5 drawable-xhdpi 
a > layout 
Ë activity mainxxml 
> @> menu 


B) stringsxml 
В styles-xml 
В AndroidManifestxxml 
В proguard-projecttxt 
'roject.proj jes 


3.13 HelloAndroid 工程 的 目录 和 文件 


bin 目录 保存 了 编译 过 程 中 产生 的 文件 ,以 及 最 终 产 生 的 apk 文件 。 

res 目录 是 资源 目录 ,Android 程序 所 有 的 图 像 、 颜 色 、 风 格 、 主 题 、 界 面 布局 和 字符 串 
等 资源 都 保存 在 其 下 的 几 个 子 目 录 中 。 其 中 , drawable-hdpi、 drawable-mdpi 和 
drawable-ldpi 目录 用 来 保存 同一 个 程序 中 针对 不 同 屏幕 尺寸 需要 显示 的 不 同 大 小 的 图 
像 文 件 ,layout 目录 用 来 保存 与 用 户 界面 相关 的 布局 文件 ,values 目录 保存 颜色 、 风 格 、 主 
题 和 字符 串 等 资源 。 在 HelloAndroid 工程 中 ,ADT 在 每 个 drawable 目录 中 自动 引入 了 
一 个 不 同 尺寸 的 icon. png X (Е. Android 系统 会 根据 目标 设备 的 屏幕 分 辨 率 ,为 
HelloAndroid 程序 加 载 不 同 尺寸 的 图 标 文件 ;在 layout 目录 生成 了 mail. xml 文件 ,用 以 
描述 图 3.7 所 显示 的 用 户 界面 ;在 values 目录 生成 了 strings. xml 文件 ,将 应 用 程序 名 称 
HelloAndroid 和 界面 显示 的 “Hello World. HelloAndroidActivity!1” 保 存在 这 个 文件 中 。 

android. jar 文件 是 Android 程序 所 能 引用 的 函数 库 文件 ,Android 系统 所 支持 АРІ 
都 包含 在 这 个 文件 中 ,具体 内 容 参 考 附录 B。 

android-support-v4. jar 是 Android 兼容 性 包 (Compatibility package) ,开发 者 可 以 
将 它 作 为 静态 库 放 进 Android 应 用 程序 中 进行 编译 ,这 样 可 以 让 一 个 在 Android 4.0 上 
开发 的 应 用 可 以 在 API level 4 的 Android 系统 中 工作 。 

proguard. cfg 文件 是 供 ProGuard 工具 进行 代码 优化 和 代码 混淆 使 用 的 配置 文件 。 

project. properties 文件 记录 了 Android 工程 的 相关 设置 ,例如 编译 目标 和 apk 设置 
等 。 该 文件 不 能 手工 修改 ,如 果 需 要 更 改 其 中 的 设置 ,必须 通过 右 击 工程 名 称 , 选择 
Properties 进行 修改 过 。 从 project. properties 文件 的 代码 中 可 以 发 现 ,大 部 分 都 是 内 容 
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注释 , 仅 第 12 行 是 有 效 代码 ,说 明了 Android 程序 的 编译 目标 。 
project. properties 文件 的 代码 如 下 。 


#This file is automatically generated by Android Tools. 
#Do not modify this file -- YOUR CHANGES WILL BE ERASED! 

+ 

#This file must be checked in Version Control Systems. 

+ 

#To customize properties used by the Ant build system use, 


#"build.properties", and override values to adapt the script to your 


#project structure. 


о © - су 0 > ш Ñ н 


m 
o 


11 4Project target. 

12 target- android- 21 

AndroidManifest. xml 是 XML 格式 的 Android 程序 声明 文件 ,包含 了 Android 系统 
运行 Android 程序 前 所 必须 掌握 的 重要 信息 。 这 些 信息 包括 应 用 程序 名 称 、 图 标 、 包 名 
ЖК ,模块 组 成 .授权 和 SDK 最 低 版 本 等 ,而 且 每 个 Android 程序 必须 在 根 目 录 下 包含 一 
个 AndroidManifest. xml 文件 。XML 是 一 种 可 扩展 标记 语言 ,本 身 独立 于 任何 编程 语 
言 ,能 够 对 复杂 的 数据 进行 编码 , 且 易 于 理解 。Android 工程 中 多 处 使 用 了 XML 文件 ， 
使 应 用 程序 开发 更 加 有 具有 弹性 , 且 易 于 后 期 的 维护 和 理解 。 

AndroidManifest. xml 文件 的 代码 如 下 。 


E «?xml version- "1.0" encoding- "utf- 8"?» 

2 «manifest xmlns:android- "http://schemas .android.com/apk/res/android" 
3 package- "edu.hrbeu.helloandroid" 

4 android:versionCode- "1" 

5 android:versionName- "1.0"> 

6 «uses- sdk 

7 android:minSdkVersion- "15" 

8 android:targetSdkVersion- "21" /» 

9 «application 

10 android:allowBackup- "true" 

11 android:icon= "@ drawable/ic launcher" 

12 android:label="@ string/app name" 

13 android:theme- "@ style/AppTheme" > 

14 «activity 

15 android:name- ".MainActivity" 

16 android:label- "8 string/app name" > 

Tf < intent- filter» 

18 <action android:name- "android.intent.action.MAIN" /> 
19 < category android:name- "android.intent.category.LAUNCHER" /> 


20 < /intent- filter> 
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21 < /activity» 
22 < /application» 
23 </manifest> 


在 AndroidManifest. xml 文件 中 , 根 元 素 是 manifest, 包 含 xmlns:android、package、 
android; versionCode 和 android; versionName 4 个 属性 。 其 中 ,第 2 行 属性 xmlns: 
android 定义 Android 的 命名 空间 , 值 为 http://schemas. android. com/apk/res/android; 
第 3 行 属 性 package 定义 应 用 程序 的 包 名 称 ; 第 4 行 属性 android: versionCode 定义 应 用 
程序 的 版 本 号 ,是 一 个 整数 值 ,数值 越 大 说 明 版 本 越 新 ,但 仅 在 程序 内 部 使 用 ,并 不 提供 
给 应 用 程序 使 用 者 ;第 5 行 属性 android: versionName 定义 应 用 程序 的 版 本 名 称 , 是 一 个 
字符 串 , 仅 限于 为 用 户 提供 一 个 版 本 标识 。 

manifest 元 素 仅 能 包含 一 个 application 元 素 ,application 元 素 中 能 够 声明 Android 
程序 中 最 重要 的 4 个 组 成 部 分 ,包括 Activity、Service、BroadcastReceiver 和 
ContentProvider, 所 定义 的 属性 将 影响 所 有 组 成 部 分 。 第 11 行 属 性 android:icon 定义 
Android 应 用 程序 的 图 标 ,其 中 @drawable/icon 是 一 种 资源 引用 方式 ,表示 资源 类 型 是 
图 像 ,资源 名 称 为 icon, 对 应 的 资源 文件 为 icon. png. 目录 是 res/drawable-hdpi, res/ 
drawable-mdpi 和 res/drawable-ldpi, 这 三 个 目录 中 的 资源 仍 通过 @ drawable 进行 调用 ; 
第 12 行 属性 android:label 则 定义 了 Android 应 用 程序 的 标签 名 称 。 

activity 元 素 是 对 Activity 子 类 的 声明 ,不 在 AndroidManifest. xml 文件 中 声明 的 
Activity 将 不 能 够 在 用 户 界面 中 显示 。 第 15 行 属 性 android: name 定义 了 实现 Activity 
类 的 名 称 ,可 以 是 完整 的 类 名 称 , 如 edu. hrbeu. MainActivity, 也 可 以 是 简化 后 的 类 名 称 ， 
11. MainActivity; 第 16 行 属 性 android:label 则 定义 Activity 的 标签 名 称 ,标签 名 称 将 在 
用 户 界 面 的 Activity 上 部 显示 ,@string/app_name 同样 属于 资源 引用 ,表示 资源 类 型 是 
字符 串 ,资源 名 称 为 app пате, VEUS TE f fE res/values 目录 下 的 strings. xml 文件 中 。 

intent-filter 中 声明 两 个 子 元 素 action 和 category, 在 这 里 不 详细 讨论 两 个 字 元 素 的 
用 途 , 但 可 以 肯定 的 是 ,intent-filter 使 HelloAndroid 程序 在 启动 时 ,将 . MainActivity 这 
个 Activity 作为 默认 启动 模块 。 

ADT 包含 了 一 个 可 视 化 的 编辑 器 ,如 图 3. 14 所 示 , 双 击 AndroidManifest. xml 文件 
可 直接 进入 可 视 化 编辑 器 。 用 户 可 以 在 不 接触 XML 的 情况 下 ,编辑 Android 工程 的 应 
用 程序 名 称 、 包 名 称 、 图 标 、 标 签 和 许可 等 相关 属性 。 

К. java 文件 是 ADT 自动 生成 的 文件 ,包含 对 drawable, layout 和 values 目录 内 的 资 
源 的 引用 指针 ,Android 程序 能 够 直接 通过 R 类 引用 目录 中 的 资源 。R. java 文件 不 能 手 
工 修改 ,所 有 代码 必须 由 ADT 自动 生成 。 如 果 向 资源 目录 中 增加 或 删除 了 资源 文件 , 则 
需要 在 工程 名 称 上 右 击 ,选择 Refresh 来 更 新 R. java 文件 中 的 代码 。 

HelloAndroid 工程 生成 的 R. java 文件 的 代码 如 下 。 


/* AUTO-GENERATED FILE. ГО NOT MODIFY. 


* 


x 
2 
3 * This class was automatically generated by the 
4 * aapt tool from the resource data it found. It 
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[ea shout the Ardea festa 
Package zdu hrbeuhelloandroid 
Veriioncode 1 


Shared user abel 

Instal! location 

Manifest Extras ӨЄ®®@ФФ@@®©@®®л: 
© Uses Sdk 


~ Exporting 
To export the application for dizibuion, yeu have the following ooticns: 
* Usa the Esport Wizard to export and sign an APK. 

* Esport an unsigned APK and sign it marualy 


E мә чем [R] Appkeation|[P] Permission (1) Iratromentation =] Атене Мае т] 


* should not be modified by hand. 
*/ 


package edu.hrbeu.helloandroid; 


public final class R ( 
public static final class attr ( 
} 
public static final class dimen { 


3.14 HelloAndroid 工程 的 目录 和 文件 


/** Default screen margins, per the Android Design guidelines. 


*/ 


public static final int activity horizontal margin- 0x7f040000; 


public static final int activity vertical margin- 0x7f040001; 


public static final class id ( 


public static final class layout ( 


public static final class menu { 


public static final class string { 


public static final int action settings- 0x7f050002; 
public static final int app name- 0х7#050000; 


public static final class drawable ( 
public static final int ic launcher- 0x7f020000; 


public static final int action settings- 0x7f080000; 


public static final int activity main- 0x7f030000; 


public static final int маіп= 0x7f070000; 
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34 public static final int hello world- 0x7f050001; 

35 } 

36 public static final class style { 

37 [ex 

38 Base application theme, dependent on API level. This theme is replaced 
39 by AppBaseTheme from res/values- vXX/styles.xml on newer devices. 
40 

41 

42 Theme customizations available in newer API levels can go in 
43 res/values- vXX/styles.xml, while customizations related to 
44 backward- compatibility can go here. 

45 

46 * d 

47 public static final int AppBaseTheme- 0x7f060000; 

48 /** Application theme. 

49 All custamizations that are NOT specific to a particular API- level can go here. 
50 ud À 

51 public static final int AppTheme- 0x7f060001; 

52 ) 

53: j 
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R 类 包含 的 几 个 内 部 类 ,分 别 与 资源 类 型 相对 应 ,资源 ID 便 保 存在 这 些 内 部 类 中 ， 
例如 子 类 drawable 表示 图 像 资 源 , 内 部 的 静态 变量 icon 表示 资源 名 称 , 其 资源 ID 为 
0x7{020000。 一 般 情况 下 ,资源 名 称 与 资源 文件 名 相同 (不 包含 扩展 名 ), 如 іс launcher 
对 应 src/drawable 目录 下 的 ic_launcher. png 文件 ,activity_main 对 应 src/layout 目录 下 
的 activity_main. xml 文件 。 

资源 的 引用 一 般 有 两 种 方法 ,一 种 方法 是 在 代码 中 引用 资源 , 另 一 种 方法 则 是 在 资 
源 中 引用 资源 。 

在 代码 中 引用 资源 时 ,需要 在 代码 中 使 用 资源 ID, 可 以 通过 [R. resource_type. 
resource name | 2X 3$ [ andrlid. R. resource. type. resource. name | 获取 资源 ID, Hp 
resource type 代表 资源 类 型 ,也 就 是 R 类 中 的 内 部 类 名 称 ;resource_name 代表 资源 名 
称 , 对 应 资源 的 文件 名 (不 包含 扩展 名 ) 或 在 XML 文件 中 定义 的 资源 名 称 属性 。 例 如 在 
MainActivity. java 中 ,第 13 行 代码 便 是 在 代码 中 对 资源 的 引用 。 

在 资源 中 引用 资源 时 ,一 般 的 引用 格式 为 @[package: jtype:name。 其 中 ,@ 表 示 对 
资源 的 引用 ;package 是 包 名 ,如 果 在 相同 的 包 内 ,package 则 可 省 略 ;type 是 资源 的 类 型 ， 
例如 string 或 drawable; name 是 资源 的 名 称 。 例 如 在 activity_main. xml 文件 中 ,第 
14 行 代码 就 是 在 资源 中 对 资源 的 引用 。 

activity_main. xml 文件 是 界面 布局 文件 ,利用 XML 语言 描述 的 用 户 界 面 , 界 面 布 局 
的 相关 内 容 将 在 第 5 章 中 进行 详细 介绍 activity_main. xml 代码 的 第 11 行 说 明 在 界面 
中 使 用 TextView 控件 , TextView 控件 主要 用 来 显示 字符 串 文本 。 代 码 第 14 行 说 明 
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TextView 控件 需要 显示 的 字符 串 ,非常 明显 ,@string/hello_world 是 对 资源 的 引用 。 通 
过 strings. xml 文件 的 第 5 行 代码 分 析 , 在 Text View 控件 中 显示 的 字符 串 应 是 “Hello 
World. HelloAndroidActivity!”。 如 果 读 者 修改 strings. xml 文件 的 第 5 行 代码 的 内 容 ， 
重新 编译 .运行 后 ,模拟 器 中 显示 的 结果 也 应 该 随 之 更 改 。 

activity main, xml 文件 的 代码 如 下 。 


1  «Relativelayout xmlns:android= "http://schemas .android.con/apk/res/android" 


2 xmlns:tools- "http: //schemas .android.com/tools" 

3 android:layout width- "match parent" 

4 android:layout height- "match parent" 

5 android:paddingBottom- "Gdimen/activity vertical margin" 
6 android:paddingLeft- "ё dimen/activity horizontal margin" 
7 android:paddingRight- "?dimen/activity horizontal margin" 
8 android:paddingTop- "@ dimen/activity vertical margin" 

9 tools:context- "edu.hrbeu.helloandroid.MainActivity" > 

10 

11 <TextView 

12 android:layout width= "wrap content" 

13 android:layout height- "wrap content" 

14 android:text- "@ string/hello world" /> 

15 


16 «/RelativeLayout» 
strings. xml 文件 的 代码 如 下 。 


1 < ?xm1 version- "1.0" encoding- "utf- 8"?> 


2 «resources» 


< string name-"app name" HelloAndroid« /string» 
«string name- "hello world"» Hello world!« /string» 


«string name-"action settings"» Settings< /string> 


очо льш 


< /resources» 


MainActivity. јауа 是 Android 工程 向 导 根 据 Activity 名 称 创 建 的 java 文件 ,这 个 文 
件 完全 可 以 手工 修改 。 为 了 在 Android 系统 上 显示 图 形 界 面 , 需 要 使 用 代码 继承 
Activity 类 ,并 在 onCreate() 函数 中 声明 需要 显示 的 内 容 。 

MainActivity. java 文件 的 代码 如 下 。 


1 package edu.hrbeu.helloandroid; 


№ 


import android.app.Activity; 


3 

4 import android.os.Bundle; 
5 import android.view.Menu; 
6 


import android.view.Menultem; 
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8 public class MainActivity extends Activity { 


9 

10 @ Override 

11 protected void onCreate (Bundle savedInstanceState) { 

1 super.onCreate (savedInstanceState); 

13 SetContentView (R.layout.activity main); 

14 } 

15 

16 @ Override 

17 public boolean onCreateOptionsMenu (Menu menu) { 

18 //Inflate the menu; this adds items to the action bar if it is present. 
19 getMenuInflater () .inflate (R.menu.main, menu); 

20 return true; 

21 } 

22 

23 @override 

24 public boolean onOptionsItemSelected (MenuItem item) { 

25 //Handle action bar item clicks here. The action bar will 
26 //automatically handle clicks on the Home/Up button, so long 
27 //as you specify a parent activity in AndroidManifest.xml. 
28 int id-item.getItemId(); 

29 if(id--R.id.action settings)( 

30 return true; 

31 } 

32 return super.onOptionsItemSelected (item); 

33 } 

34 } 

35 


代码 的 第 3 行 和 第 4 行 , 通 过 android. jar 从 Android SDK 中 引入 了 Activity 和 
Bundle 两 个 重要 的 包 , 用 以 子 类 继承 和 信息 传递 ;第 8 行 声 明 MainActivity 类 继承 
Activity 类 ;第 10 行 表明 需要 重 写 onCreateO PR ZG; 58. 11 行 的 onCreate() 会 在 Activity 
首次 启动 时 被 调用 ,为 了 便于 理解 ,可 以 认为 onCreate() 是 HelloAndroid 程序 的 主人 口 
函数 ;第 12 行 调用 父 类 的 onCreate OO 函数 ,并 将 savedInstanceState 传递 给 父 类 ， 
savedInstanceState 是 Activity 的 状态 信息 ;第 13 行 声明 了 需要 显示 的 用 户 界面 ,此 界面 
是 用 XML 语言 描述 的 界面 布局 ,保存 在 scr/layout/activity_main. xml 资源 文件 中 。 

到 这 里 分 析 了 Android 程序 的 目录 结构 和 文件 的 用 途 , 对 AndroidManifest. xml Ж 
fF Java 代码 文件 .资源 引用 和 К. java 等 内 容 有 了 初步 的 了 解 。3. 3 节 将 介绍 如 何 使 用 
最 新 的 集成 开发 环境 Android Studio 创建 Android 程序 。3. 4 节 将 着 重 介 绍 如 何 使 用 命 
令 行 工具 创建 Android 程序 ,有 助 于 深入 理解 Android 程序 的 生成 .安装 和 运行 过 程 。 
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33 Android Studio 创建 应 用 程序 


使 用 Android Studio 创建 Android 工程 的 基本 流程 与 使 用 Eclipse 类 似 。 在 启动 
Android Studio 后 ,进入 如 图 3. 15 所 示 界 面 。 如 果 是 第 一 次 启动 的 话 ,首先 需要 配置 
SDK 位 置 ,选择 Configure— Project Deflfaults— Project Struture ,选择 之 前 安装 Android 
SDK 的 位 置 , 如 图 3. 16 所 示 。 


两 Android Studio J 
pod Welcome to Android Studio 


(oem eee | | 
ER Start a new Android Studio project 
= Open an existing Android Studio project 
No Project Open Yet 5 ан ааа 
^d Check out project from Version Control 


& Import Non-Android Studio project 


图 3.15 建立 新 工程 


Android SDK location: 
The drectory where the Android SDK is located. This location wil be used for new projecta, and for existing projects thet до not hove e 
local properties fle with a sdicdir property. 


DMindroid\sdk\android-sdk - 


JOK location: 
The drectory where the Java Development K JDK) is located. 


Cragram Files \Java\jdk1.8.0.40 


图 3.16 配置 SDK 路 径 


之 后 返回 最 初 界面 ,选择 Start a new Android Studio project ,建立 一 个 新 的 工程 , 需 
要 在 Application name 栏 中 填 人 应 用 名 称 ,在 Company Domain 栏 中 填 和 人 公司 域名 ,然后 
Android Studio 会 自动 将 生成 “公司 域名 倒置 十 应 用 名 称 ” 的 包 名 ,并 保持 Android 的 命 
名 规范 ,如 图 3.17 所 示 。 
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RE [D AndroidstudioworcptaceuMyapptcation2 


3.17 新 建 工程 


单 击 Next 按钮 后 ,可 以 根据 需要 ,选择 创建 适用 与 手机 与 平板 电脑 的 Android 工 
程 ,同时 还 提供 创建 适用 于 电视 .可 穿戴 设备 .谷歌 眼镜 的 Android 工程 (需要 在 SDK 
Manager 中 下 载 所 需 的 套件 )。 之 后 操作 与 Eclipse 类 似 ,需要 在 Minimum SDK 栏 中 选 
择 能 运行 的 最 低 版 本 的 SDK. Android Studio 自 带 了 英文 说 明 ,推荐 使 用 АРІ 15, 可 以 支 
持 目 前 大 部 分 的 设备 ,如 图 3. 18 所 示 。 


[ > Create New Projet 


New Project 
Ardreid Studio 


Select the form factors your app will run оп 


Different platforms require separate SOS 


/API 15: Android 40.3 (cecreamSandwich) H 


Lower API levels target more devices, but have fewer features avaiable. By targeting API 15 and 
later, your opp wil run on approximately 87.9% of the devices that ore active on the Googie Pley 
me choose. 


Store. Help 


图 3.18 选择 支持 的 最 低 SDK 版 本 


之 后 根据 需要 ,可 以 选择 合适 的 页 面 模板 ,简化 开发 工作 ,选择 Blank Activity 建立 
一 个 空白 的 Activity 即 可 ,如 图 3. 19 所 示 。 
与 Eclipse 类 似 , 在 填写 Activity 名 称 和 相关 布局 文件 名 称 后 , 即 可 创新 一 个 新 的 工 
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程 ,如 图 3.20 所 示 。 


Add an activity to Mobile 


i 
Add No Activity 25 


| э. Faseren by 


3.19 选择 页 面 模板 


un ded МС) iden Hep 
Drei та Ева 了 а 
0 B dirt manami 


wwen mmm 
Brenas. [e @аретеле Tena. (QD. л Component ie FEES "d 
Ш= «азд «Porcio H 
"aaa H 
СО N 
e 

Porote тэт 


T000 Biurui SO Meme ФЕ Фоа 
[BI саьй buid frished in 37 see [в mintes age) 


3.20 选择 项 目 模板 


在 Android Studio 提供 的 实时 预览 窗口 中 ,此 时 已 经 可 以 看 到 程序 运行 后 显示 的 
“Hello world FE. 

在 Android Studio 中 可 以 通过 Tools—>Android>AVD Manager 启动 AVD 管理 器 ， 
也 可 以 使 用 快捷 的 方法 ,点 击 上 方 工具 栏 中 机 器 人 与 手机 的 图 标 , 即 可 打开 АУР 管理 


器 ,如 图 3.21 所 示 o 
单 击 Creat a virtual device 按钮 即 可 创建 新 的 虚拟 设备 ,除了 界面 稍 有 区 别 ,AVD 


的 创建 方法 与 Eclipse 中 基本 相同 ,并且 模拟 器 界面 相同 ,在 此 不 再 缆 述 。 
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[окш 


Your Virtual Devices 


Virtua! devices allow you to test your application without 
having to cwn the physical devices 


Te prioritize which devices to test your application on visit 
me 


3.21 创建 虚拟 设备 


ЗА 命令 行 创建 应 用 程序 


通过 前 面 章节 的 学 习 , 读 者 已 可 以 使 用 Eclipse 或 Android Studio 建立 Android 应 
用 程序 。 这 些 集成 开发 环境 能 够 为 使 用 者 提供 良好 的 编辑 和 调试 环境 ,并 能 够 自动 完成 
程序 的 编译 apk 打包 和 上 传 安装 等 过 程 , 但 这 样 也 屏 项 了 很 多 细节 。 

本 节 将 尝试 使 用 文本 编辑 器 和 命令 行 工具 创建 Android 程序 HelloCommondline， 
这 种 命令 行 的 方法 可 以 完整 地 展示 创建 Android 程序 的 全 部 过 程 。 如 果 读 者 对 使 用 命 
令 行 工 具 开 发 Android 程序 并 不 感 兴趣 ,完全 可 以 跳 过 本 节 。 

在 介绍 使 用 命令 行 工具 开发 Android 程序 前 ,首先 介绍 如 何 通过 命令 行 建立 AVD, 
并 通过 命令 行 启动 Android 模拟 器 。 

建立 АУР 需要 使 用 Windows 系统 的 命令 行 工具 CMD, 从 “开始 ” 一 “运行 ”一 
“CMD” 中 启动 命令 行 工具 ,并 进入 二 Android SDK>> /tools H 3t F , HP < Android SDK> 
表示 Android SDK 所 在 的 目录 ,笔者 的 Android SDK 安装 在 D: VAndroid SDKNandroid-sdk 
目录 中 。 

首先 通过 android list targets f 4 18 R < Android SDK — /platforms 和 所 Android 
SDK /add-ons 目录 下 所 有 有 效 的 Android 系统 ,并 将 Android 系统 映像 列表 显示 出 
来 ,如 图 3. 22 所 示 。 共 有 两 个 可 以 选择 的 编译 目标 ,分 别 是 5. 0. 1 版 本 Android 系统 和 
支持 Google API 的 5. 0. 1 版 本 Android 系统 。 

使 用 android create avd -n android5. 0. 1 -t 1 命令 ,以 id 为 1 的 4.0 版 本 Android £ 
统 为 目标 ,建立 一 个 名 为 android5.0. 1 的 AVD。 其 中 ,-n 参数 表明 AVD 的 名 称 ,-t 参数 
表明 选择 的 Android 系统 的 id 值 。 输入 АУР” 创建 命令 后 ,系统 会 询问 用 户 是 否 需要 定 
制 硬件 配置 清单 (Do you wish to create a custom hardware profile) ,这 里 选择 no. fii JH] E 
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hdroid 2 A 4$ 2 # Z (F зА) 


===) 


Е 
画 CAWindowssystem32kmdee К A к ж 2 шж ж к 22 ж 


A. WUGRSBB Cdefault), 


UGA, WUGñ800 Cdefault), W 


Tag/RBI 


:Mindroid S 


图 3.22 Android 系统 映像 列表 


认 的 硬件 配置 ,运行 结果 如 图 3. 23 所 示 。 当 然 也 可 以 选择 yes, 根 据 需要 重新 定制 模拟 
器 支持 的 硬件 清单 。 


E C\Windows\system32\cmd.exe =) 


图 3.23 建立 AVD 


建立 AVD 过 程 中 ,Android 工具 会 在 文件 系统 中 建立 Android5. 0. 1. ini 文件 和 
Android5. 0. 1. avd 目录 。 其 中 ,Android5. 0. 1. ini 文件 标识 出 模拟 器 的 版 本 和 模拟 器 所 
在 的 目录 ;Android5. 0. 1. avd 目录 则 是 模拟 器 的 工作 目录 ,用 以 保存 AVD 配置 文件 .用 
户 数据 文件 .SD 卡 映 像 和 模拟 器 运行 过 程 中 可 能 产生 的 文件 。Android5. 0. 1. ini 文件 和 
Android5. 0. 1. ауа 目录 的 保存 位 置 ,会 根据 用 户 使 用 的 操作 系统 不 同 而 不 同 ,如 果 用 户 
使 用 的 是 Windows ХР 系统 , 则 目录 保存 在 C:\Documents and Settings\ < изег >N. 
android\ 下 ;如 果 用 户 使 用 的 是 Windows 7 系统 , 则 会 保存 在 C:NUsersN < user > N. 
android 下 。AVD 的 管理 命令 和 虚拟 硬件 列表 可 以 参考 附录 А. 

Android 模拟 器 不 能 通过 直接 双击 二 Android SDK >> /tools 目录 下 的 emulator. exe 
启动 ,必须 在 启动 模拟 器 时 指定 所 使 用 的 AVD。 使 用 android list avds 命令 查询 已 经 建 
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立 的 AVD, 查 询 结果 如 图 3. 24 所 示 。 


ES CAWindows\system32\emd exe ИШ. 


一 


图 3.24 已 有 AVD 列表 


笔者 系统 中 有 两 个 AVD, 两 个 都 是 5.0. 1 版 本 的 Android 系统 ,其 中 Android5. 0. 1 
是 刚刚 通过 命令 行 建 立 的 AVD. Æ CMD 中 输入 命令 emulator -avd Android5. 0. 1 [ifi 
即 可 以 看 到 Android 模拟 器 的 启动 界面 。 

AVD 创建 完毕 后 ,就 可 以 进入 Android 应 用 程序 开发 过 程 了 ,首先 熟悉 一 下 
Android 命令 行 工具 的 位 置 。 

Android 命令 行 工 具 存放 在 二 Android SDK /tools 和 二 Android SDK 二 /platform- 
tools 目录 中 ,这些 命 令 行 工 具 非 常 重要 ,即使 用 户 使 用 Eclipse 开发 Android 程序 ,很 多 
重要 的 功能 也 都 是 调用 这 些 命令 行 工具 完成 的 。 

下 面 的 内 容 将 介绍 如 何 使 用 命令 行 工具 开发 Android 程序 ,其 过 程 一 般 分 为 如 下 几 
TER. 

(1) 使 用 android. bat 建立 HelloCommondline 工程 所 需 的 目录 和 文件 ; 

(2) 使 用 Apache Ant 对 HelloCommondline 工程 进行 编译 和 apk 打包 ; 

(3) 使 用 adb. exe 将 HelloCommondline 工程 上 传 到 Android 模拟 器 中 。 

第 一 步 , 使 用 android. bat 建立 HelloCommondline 工程 所 需 的 目录 和 文件 。 
android. bat 是 一 个 批 处 理 文件 ,可 以 用 来 建立 和 更 新 Android 工程 ,同时 也 可 以 管理 
AVD。android. bat 能 够 创建 Android 工程 所 需要 的 目录 结构 和 文件 , 表 3.2 给 出 了 
android. bat 建立 和 更 新 Android 工程 的 命令 和 参数 说 明 。 


表 3.2 Android 工程 管理 命令 


LÀ * $9 b 说 明 备 注 
-k <package> 包 名 称 必 备 参数 
-n <name> 工程 名 称 
android create project -a <activity > Activity 名 称 
-t <target> 新 工程 的 编译 目标 必 备 参数 
-p <path> 新 工程 的 保存 路 径 必 备 参数 
-t <targe> 设 定 工程 的 编译 目标 必 备 参数 
android update project -p <path> 工程 的 保存 路 径 必 备 参数 
-п <name> 工程 名 称 
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使 用 android. bat 建立 Android 工程 ,需要 从 “开始 ”一 “运行 * 一 CMD 启动 CMD ,并 
进入 二 Android SDK 二 /tools 目录 ,首先 通过 android list targets 命令 搜索 有 效 的 
Android 系统 ,搜索 结果 如 图 3. 14 所 示 ,这 里 选择 目标 系统 的 ID 为 1。 

然后 输入 如 下 命令 建立 工程 目录 和 基本 文件 。 


android create project - n HelloCommandline - К edu. hrbeu. HelloCommandline - a 
HelloCommandline -t 1 -p 9:\Апагоіа\могкр1асе\Не110Соптапаїіпе 


新 工程 名 称 为 HelloCommandline, 包 名 为 edu. hrbeu. HelloCommandline, Activity 
名 称 是 HelloCommandline, 编译 目标 的 ID 为 1. 新 工程 的 保存 路 径 是 g: NAndroidN 
workplace\ HelloCommandline。 另 一 种 命令 输入 方法 如 下 。 


android create project - - name HelloCommandline - - package edu.hrbeu. 
HelloCommandline -- activity HelloCommandline - - target 1 - - path g: VAndroid workplace 
MHelloCommandline 


输入 命令 后 的 运行 结果 如 图 3. 25 所 示 ,建立 了 用 于 HelloCommandline 工程 的 目录 
和 文件 。 使 用 命令 行 工具 创建 的 Android 工程 可 以 移动 到 其 他 目录 中 ,因为 在 android 
. bat 在 工程 创建 过 程 中 ,在 local. properties 中 保存 了 Android SDK 的 路 径 , 因 此 工程 建 
立 后 ,建议 不 要 改变 Android SDK 的 保存 路 径 。 


89 管理 员 : C\Windows\system32\cmd.exe |) 


«Lm 


图 3.25 android 命令 的 运行 结果 


仔细 观察 android. bat 建立 的 目录 和 文件 ,发 现 其 中 一 些 在 Eclipse 开发 环境 中 从 未 
出 现 过 的 目录 和 文件 ,例如 build. xml,ant. properties 和 local. properties 目录 。 这 些 新 
目录 和 文件 的 出 现 , 主 要 是 为 了 在 构建 Android 程序 时 使 用 自动 化 工具 Apache Ant。 
Apache Ant 是 一 个 将 软件 编译 测试、 部署 等 步骤 联系 在 一 起 的 自动 化 工具 ,多 用 于 
Java 环境 中 的 软件 开发 。 在 Android 程序 构建 中 使 用 Apache Ant, 可 以 简化 程序 的 编译 
和 apk 打包 过 程 。 

在 系统 中 新 增加 的 变量 如 表 3. 3 所 示 。 其 中 ,JAVA_HOME Æ JDK 的 安装 目录 
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根据 JDK 实际 安装 位 置 进行 修改 ; ANT_HOME Æ Apache Ant 的 安装 目录 ,根据 
Apache Ant 实际 安装 位 置 进 行 修改 ;ANDROID_HOME 是 Android SDK 的 安装 目录 ， 
根据 实际 安装 位 置 进行 修改 ;CLASSPATH 是 需要 使 用 的 库 文件 的 位 置 ;Path 是 可 执行 
文件 的 搜索 路 径 , 将 二 Apache Ant>/bin, <JDK>/bin #< Android SDK > /tools 三 个 


目录 追加 到 原 有 的 Path 变量 值 中 ,目录 之 间 使 用 分 号 分 隔 。 
表 3.3 新 增 的 系统 环境 变量 
变量 名 # ш d & x 
JAVA HOME C:\Program Files\Java\jdk1. 8. 0. 40 新 增 变 量 
ANT_HOME E:\Android\apache-ant-1. 8.2 新 增 变量 
ANDROID HOME | E:\Android\android-sdk-windows 新 增 变 量 


$ JAVA HOME\jre/lib; $ JAVA_HOME\lib; $ ЈАУА НОМЕ/ 


lib/tools. jar 


;HANT_ HOMEX \ bin; 4 JAVA. НОМЕ \bin; % ANDROID W 
Path I М 已 有 变量 
HOME %Ntools; % ANDROID HOME Nplatform-tools; 


CLASSPATH 新 增 变 量 


第 二 步 ,编译 和 打包 。 环 境 变 量 设置 完毕 后 ,可 以 在 CMD 中 运行 ant 命令 ,通过 命 
令 的 输出 判断 环境 变量 是 否 正 确 设置 。 如 果 输 出 的 提示 包含 “Unable to locate tools. 
jar. Expected to find it in + ”, 则 表明 没有 正确 设置 环境 变量 。 如 果 环 境 变量 设置 1 
确 ,ant 命令 的 输出 结果 应 为 "Buildfile: build. xml does not exist1”, 如 图 3. 26 所 示 。 


Ей SA: C\Windows\system32\cmd.exe a 


3.26 ant 命令 的 输出 结果 


Apache Ant 已 经 可 以 正常 运行 了 ,但 在 建 Android 程序 前 ,首先 介绍 一 下 
Android 程序 的 数字 签名 机 制 。 在 Android 平台 上 开发 的 所 有 应 用 程序 ,在 安装 到 模拟 
fi ak ти 进行 数字 签名 。 如 果 3 нч 的 Android 程序 安装 到 模 
拟 器 中 ,将 返回 错误 提示 Failure [INSTALL. РАКЅЕ FAILED. NO CERTIFICATERS ], 

在 кеча 开发 环境 中 ,ADT 将 Android 程序 安装 到 模拟 器 前 ,会 利于 内 置 的 debug 
key 为 apk 文件 自动 进行 数字 签名 ,这 使 用 户 无 须 自己 生产 数字 签名 的 私 钥 ,而 能 够 利于 
debug key 快速 完成 程序 调试 。 但 有 一 点 需要 注意 ,如 果 用 户 希 望 正式 发 布 自己 的 应 用 
程序 , 则 不 能 使 用 debug key ,必须 使 用 私有 密 钥 对 Android 程序 进行 数字 签名 

Apache Ant 构建 Android 应 用 程序 时 ,支持 Debug 和 Release 两 种 构建 模式 。Debug 
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模式 是 供 调试 使 用 的 构建 模式 ,用 于 快速 测试 所 开发 的 应 用 程序 ,Debug 模式 自动 使 用 
debug key 完成 数字 签名 。Release 模式 是 正式 发 布 应 用 程序 时 使 用 的 构建 模式 ,生成 没 
有 数字 签名 的 apk 文件 。 

这 里 使 用 Apache Ant 的 Debug 模式 对 HelloCommandline 工程 进行 编译 ,生成 具 
有 debug key 的 арк 打包 文件 。 使 用 CMD, 在 工程 的 根 目 录 下 ,输入 ant debug, 显 示 结 
果 如 图 3. 27 所 示 。 


к=н= 


Юй 管理 员 : CAWindows|system32Vcmd.exe. 


图 3.27 ant debug 的 输出 结果 


命令 运行 后 , Apache Ant 在 bin 目录 中 生成 打包 文件 HelloCommandline-debug 
.apk 和 HelloCommandline-debug-unaligned. арк. т HelloCommandline-debug. apk 是 
使 用 debug key 进行 过 数字 签名 的 打包 文件 ,HelloCommandline-debug-unaligned. арк 
是 未 签名 的 打包 文件 。 如 果 需 要 使 用 Release 模式 , 则 需 在 CMD 中 输入 ant release, Ж 
行 后 会 在 bin 目录 中 生成 打包 文件 HelloCommandline-unsigned. apk。 

apk 文件 是 Android 系统 的 安装 程序 ,上 传 到 Android 模拟 器 或 Android 手机 后 可 
以 进行 安装 。apk 文件 本 身 是 一 个 zip 压缩 文件 ,能够 使 用 WinRAR, UnZip 等 软件 直接 
打开 ,图 3.28 是 用 WinRAR 打开 的 HelloCommandline-debug. арк 文件 。 
其 中 ,res 目录 用 来 存放 资源 文件 ;AndroidManifest. xml 是 Android 程序 的 声明 文 
件 ;classes. dex 是 Dalvik 虚拟 机 的 可 执行 程序 ;resources. arse 是 编译 后 的 二 进 制 资源 
文件 。 
第 三 步 , 使 用 adb. exe 将 HelloCommondline 工程 上 传 到 Android 模拟 器 中 。 
Android 模拟 器 正常 启动 后 ,利于 adb. exe 工具 能 够 把 HelloCommandline-debug 
.apk 文 件 上 传 的 模拟 器 中 adb. exe 工具 的 命令 和 参数 可 以 参考 附录 C。 这 个 工具 除了 
能 够 在 Android 模拟 器 中 上 传 和 下 载 文件 ,还 能 够 管理 模拟 器 状态 ,是 调试 程序 时 不 可 
缺少 的 工具 之 一 。 在 CMD 中 .进入 过 HelloCommandline > /bin 目录 ,输入 命令 adb 
install HelloCommandline-debug. apk ,完成 арк 程序 上 传 到 模拟 器 的 过 程 。 如 果 上 传 成 
功 ,将 显示 图 3. 29 所 示 结 果 。 


章 第 一 个 Android 程序 63 


Ei 
a 


т л 
$ HelloCommandline-debug.apk - WinRAR cle) 
хеб SCO ING SERO IAN) PMW 
添加 SEN Y. ss m m вэ 信息 | вава ER айн 
[E] ||| | HelloCommandline-debug.apk - ZIP БВУ, 解 包 大 小 为 6.023 F5 ~ 
[a uh EJ 类 型 修改 时 间 CRC32 
META-INF Folder 
res Folder 
国 AndroidManifestxml 1320 523 XML Document 2011/10/20 2.. D6F11E91 
[A classes.dex 1744 848 文件 dex 2011/10/20 2.. 502E4F20 
[3 resources.arsc 772 772 文件 arsc 2011/10/20 2.. 7CE99D... 
EP Bi 2 文件 夹 和 3,836 字 节 (3 个 文件 ) 
K 三 -— = — E m EN 


3.28 HelloCommandline-debug. apk 文件 


›1п>айЬ install HelloCommandline 


oCommandline-debug.apk 


|С: android uorkplacewHelloConnandline*bin 


3.29 向 模拟 器 中 上 传 apk 文件 


apk 文件 上 传 后 ,并 不 会 在 Android 模拟 器 
HelloCommandline 2 在 图 3. 30 的 左下 方 ,能 找 
到 刚刚 安装 的 HelloCommandline 程序 , 单 击 图 标 即 
可 启动 应 用 程序 。 如 果 在 模拟 器 中 找 不 到 
HelloCommandline 程序 ,尝试 重新 启动 Android 模 
拟 器 。 因 为 Android 的 包 管 理 器 (Package Manager) 
经 常 仅 在 模拟 器 启动 的 时 候 检查 应 用 程序 的 
AndroidManifest. xml 文件 ,这 就 导致 部 分 上 传 的 
Android 应 用 程序 不 能 立即 启动 。 

用 户 在 修改 HelloCommandline 工程 代码 后 
要 使 用 Apache Ant 重新 编译 和 打包 应 用 程序 ,并 将 
新 生成 的 apk 文件 上 传 到 Android 模拟 器 中 。 但 如 
果 新 程序 的 包 名 称 没有 改变 , 则 在 使 用 adb. exe 上 传 


apk 文件 到 模拟 器 时 ,会 出 现 错 误 提 示 : Failure 


[INSTALL_FAILD_ALREADY_EXISTS], 如 图 3. 31 
所 示 。 

此 时 ,需要 在 模拟 器 中 先 删 除 原 有 арк > 件 , 再 
使 用 adb. exe 工具 上 传 新 的 арк 文件 。 删 除 已 经 安装 


-直接 运行 ,需要 用 户 手 工 启动 


Browser Calculator Calendar 


© # ё 


Camera Custom Loca DevTools 


гаж B 


Downloads Email Gallery — GesturesBui 


2 本 轩 


HelloAndroid HelloComm: Messaging 


m 2 = 


People Phone Search 


图 3.30 模拟 器 中 的 应 用 程序 
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Ей 管理 员 : C\Windows\system32\cmd.exe [EI] 


С: \Android\workplace HelloConnandline\binYadb install Не11оСоттап&д11пе-йеһия.арК 


М4 KB. 3 in 0.29 


andline-debug.apk 
Failure [ 


c: android workplacewWlelloConnandline 


图 3.31 安装 文件 已 存在 的 错误 提示 


在 Android 系统 中 的 арк 文件 可 使 用 “adb uninstall 二 包 名 称 二 ”的 方法 ,例如 删除 
HelloCommandline 工程 的 арк 文件 . 则 可 在 CMD 中 输入 命令 adb uninstall edu. hrbeu. 
HelloCommandline, 提 示 Success 则 表示 成 功 删 除 ,如 图 3. 32 所 示 。 


画 管理 员 : C\Windows\system32\cmd.exe lie 


3: Android\Wworkplace HelloConnandline\bin>Yadb uninstall edu.hrbeu.HelloConnandli 


ndroid\workplace HelloConnandline \hin 


图 3.32 删除 已 安装 程序 


1. Ж К. java 和 AndroidManefiest. xml 文件 的 用 途 。 

2. 尝试 建立 一 个 支持 Google APIs 的 AVD. 

3. 使 用 Eclipse 建立 名 为 MyAndroid 的 工程 , 包 名 称 为 edu. hrbeu. MyAndroid ,使 
用 第 2 题 中 建立 的 AVD, 程 序 运行 时 显示 Hello MyAndroid。 

4. 使 用 Android Studio 建立 名 为 MyAndroidStudio 的 工程 , 包 名 称 为 edu. hrbeu. 
MyAndroidStudio ,程序 运行 时 显示 Hello MyAndroidStudio。 

5. 尝试 使 用 命令 行 方式 建立 一 个 Android 应 用 程序 .并 完成 apk 打包 和 程序 安装 
过 程 。 


Android 生命 周期 


Android 生命 周期 是 从 程序 启动 到 程序 终止 的 全 过 程 。 本 章 将 让 读者 深入 理解 
Android 系统 管理 生命 周期 的 必要 性 ,并 以 Activity 为 例 说 明 Android 系统 如 何 管理 程 
序 组 件 的 生命 周期 。 对 调试 方法 和 工具 的 介绍 ,有 助 于 程序 开发 人 员 快 速 找到 程序 中 的 
错误 ,而 且 可 以 对 特殊 的 事件 回调 函数 进行 调试 。 

本 章 学 习 目 标 : 

。 了 解 Android 系统 的 进程 优先 级 的 变化 方式 ; 

* 了 解 Android 系统 的 四 大 基本 组 件 ; 

。 了 解 Activity 的 生命 周期 中 各 状态 的 变化 关系 ; 

。 掌握 Activity 事件 回调 函数 的 作用 和 调用 顺序 ; 

。 掌握 Android 应 用 程序 的 调试 方法 和 工具 。 
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软件 生命 周期 是 软件 从 产生 到 废弃 所 历经 的 几 个 阶段 ,一 般 包 括 可 行 性 分 析 、 开 发 
计划 、 需 求 分 析 与 设计 .编码 .测试 和 维护 等 过 程 。 
Android 的 程序 生命 周期 与 软件 生命 周期 的 定义 不 同 , 指 高 优先 级 
的 是 在 Android 系统 中 进程 从 启动 到 终止 的 所 有 阶段 ,也 
就 是 Android 程序 启动 到 停止 的 全 过 程 。 
Android 系统 一 般 是 运行 在 资源 受 限 的 硬件 平台 上 ， 
因此 资源 管理 对 Android 系统 至 关 重 要 。Android 系统 主 
动 管 理 资源 ,为 了 保证 高 优先 级 程序 正常 运行 ,可 以 在 无 
任何 警告 的 情况 下 终止 低 优先 级 程序 ,并 回收 其 使 用 的 系 
统 资源 。 因 此 Android 程序 并 不 能 控制 自身 的 生命 周期 ， 
而 完全 是 由 Android 系统 进行 调度 和 控制 的 。 低 优先 级 
Android 系统 尽 可 能 不 主动 终止 应 用 程序 ,即使 生命 
周期 结束 的 程序 也 会 保存 在 内 存 中 ,以 便 再 次 快速 启动 。 
但 在 内 存 紧 张 时 ,系统 会 根据 进程 的 优先 级 清除 进程 , 回 图 4.1 进程 优先 级 
收 系统 资源 。Android 系统 中 的 进程 优先 级 如 图 4.1 所 


中 优先 级 
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IR ,优先 级 有 高 到 低 分 别 为 前 台 进 程 .可 见 进程 .服务 进程 后 台 进 程 和 空 进程 。 
1. 前 台 进 程 


前 台 进 程 是 Android 系统 中 最 重要 的 进程 ,是 与 用 户 正在 交互 的 进程 ,包含 以 下 四 
种 情况 ; 

* 进程 中 的 Activity 正在 与 用 户 进行 交互 ; 

。 进程 服务 被 Activity 调用 ,而 且 这 个 Activity 正在 与 用 户 进行 交互 ; 

° 进程 服务 正在 执行 声明 周期 中 的 回调 函数 ,如 onCreate()、onStart C) 或 

onDestroy(O ; 

。 进程 的 BroadcastReceiver 正在 执行 onReceive() М. 

Android 系统 在 多 个 前 台 进 程 同 时 运行 时 ,可 能 会 出 现 资源 不 足 的 情况 ,此 时 会 清除 
部 分 前 人 台 进 程 ,保证 主要 的 用 户 界面 能 够 及 时 响应 。 


2. 可 见 进程 


可 见 进程 指 部 分 程序 界面 能 够 被 用 户 看 见 , 却 不 在 前 台 与 用 户 交互 ,不 响应 界面 事 
件 的 进程 。 例 如 ,新 启动 的 Android 程序 将 原 有 程序 部 分 遮挡 , 原 有 程序 从 前 台 进 程 变 
为 可 见 进程 。 另 外 ,如 果 一 个 进程 包含 服务 , 且 这 个 服务 正在 被 用 户 可 见 的 Activity 调 
用 ,此 进程 同样 被 视 为 可 见 进程 。 一 般 Android 系统 会 存在 少量 的 可 见 进程 ,只 有 在 极 
端的 情况 下 ,Android 系统 才 会 为 保证 前 台 进 程 的 资源 而 清除 可 见 进程 。 


3. 服务 进程 


一 个 包含 已 经 启动 的 服务 的 进程 就 是 服务 进程 。 服 务 没有 用 户 界 面 , 不 与 用 户 直接 
交互 ,但 能 够 在 后 台 长 期 运行 ,提供 用 户 所 关心 的 重要 功能 ,例如 播放 МРЗ 文件 或 从 网 
络 下 载 数据 。 因 此 ,Android 系统 除非 不 能 保证 前 台 进 程 或 可 视 进 程 所 必要 的 资源 ,否则 
不 强行 清除 服务 进程 。 


4. 后 台 进 程 


如 果 一 个 进程 不 包含 任何 已 经 启动 的 服务 ,而 且 没有 任何 用 户 可 见 的 Activity, 则 这 
个 进程 就 是 后 台 进 程 。 例 如 一 个 仅 有 Activity 组 件 的 进程 , 当 用 户 启动 了 其 他 应 用 程序 
使 这 个 进程 的 Activity 完全 被 遮挡 , 则 这 个 进程 便 成 为 后 台 进 程 。 一 般 情况 下 ,Android 
系统 中 存在 数量 较 多 的 后 台 进 程 ,在 系统 资源 紧张 时 ,系统 将 优先 清除 用 户 较 长 时 间 没 
有 见 到 的 后 人 台 进 程 。 

5. 空 进程 

空 进程 是 不 包含 任何 活跃 组 件 的 进程 ,例如 一 个 仅 有 Activity 组 件 的 进程 , 当 用 户 
关闭 Activity 后 ,这 个 进程 就 成 为 空 进程 。 空 进程 在 系统 资源 紧张 时 会 被 首先 清除 ,但 


为 了 提高 Android 系统 应 用 程序 的 启动 速度 ,Android 系统 会 将 空 进程 保存 在 系统 内 存 
中 ,在 用 户 重新 启动 该 程序 时 , 空 进程 会 被 重新 使 用 。 
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在 Android 中 ,进程 的 优先 级 取决 于 所 有 组 件 中 的 优先 级 最 高 的 部 分 。 例 如 ,在 进 
程 中 同时 包含 部 分 可 见 的 Activity 和 已 经 启动 的 服务 , 则 该 进程 是 可 见 进程 ,而 不 是 服 
务 进程 。 另 外 ,进程 的 优先 级 会 根据 与 其 他 进程 的 依赖 关系 而 变化 。 例 如 ,进程 A 的 服 
务 被 进程 B 调用 ,如 果 调 用 前 进程 A 是 服务 进程 ,进程 B 是 前 台 进 程 , 则 调用 后 进程 A 
也 具有 前 台 进 程 的 优先 级 。 


42 Android 组 件 


Android 应 用 程序 由 组 件 组 成 ,组 件 是 可 以 被 调用 的 基本 功能 模块 。Android 系统 
利用 组 件 实现 程序 内 部 或 程序 间 的 模块 调用 ,以 解决 代码 复 用 的 问题 ,这 是 Android 系 
统 非常 重要 的 特性 。 在 程序 设计 时 ,在 AndroidManifest. xml 中 声明 可 共享 的 组 件 ,声明 
后 其 他 应 用 程序 可 以 直接 调用 这 些 共享 组 件 。 例 如 ,程序 A 实现 了 文件 压缩 的 功能 ,并 
对 外 共享 了 这 个 组 件 ,程序 B 则 不 必 再 开发 文件 压缩 功能 ,而 直接 调用 程序 A 的 共享 组 
件 即 可 。 

但 这 种 特性 存在 这 样 一 个 问题 ,如 果 共 享 组 件 所 在 的 进程 没有 启动 ,这 个 共享 组 件 
不 能 被 其 他 程序 调用 。 为 了 解决 这 一 问题 ,Android 系统 必须 能 够 在 其 他 程序 调用 共享 
组 件 时 ,能 够 直接 启动 被 调用 的 共享 组 件 。 因 此 ,Android 系统 没有 使 用 常见 的 应 用 程序 
入 口 点 (类 似 于 Java 程序 的 Main 函数 ) 的 方法 ,而 是 允许 共享 组 件 被 Android 系统 直接 
实例 化 ,从 而 保证 能 够 调用 进程 没有 启动 的 共享 组 件 。 

Android 系统 有 4 个 重要 的 组 件 , 分 别 是 Activity, Service, Broadcase receiver 和 
Content provider。 

Activity 是 Android 程序 的 呈现 层 ,显示 可 视 化 的 用 户 界面 ,并 接收 与 用 户 交互 所 产 
生 的 界面 事件 ,与 “ 窗 体 ” 的 概念 非常 相似 。Android 应 用 程序 可 以 包含 一 个 或 多 个 
Activity ,一 般 在 程序 启动 后 会 呈现 一 个 Activity, 用 于 提示 用 户 程 序 已 经 正常 启动 。 
Activity 在 界面 上 的 表现 形式 一 般 是 全 屏 窗 体 ,也 可 以 是 非 全 屏 悬 浮 窗 体 或 对 话 框 。 

Service 一 般 用 于 没有 用 户 界面 ,但 需要 长 时 间 在 后 台 运 行 的 应 用 。 例 如 ,在 播放 
MP3 音乐 时 ,使 用 Service 播放 MP3 音乐 ,可 以 在 关闭 播放 器 界面 的 情况 下 长 时 间 播 放 
MP3 音乐 ,并 通过 对 外 公开 Service 的 通信 接口 ,控制 МРЗ 音乐 播放 的 启动 .暂停 和 
停止 。 

Broadcase receiver 是 用 来 接收 并 响应 广播 消息 的 组 件 。 大 部 分 广播 消息 是 由 系统 
产生 的 ,例如 时 区 改变 .电池 电量 低 或 语言 选项 改变 等 ,但 应 用 程序 也 可 以 产生 广播 消 
息 , 例 如 数据 下 载 完 毕 等 。Broadcast receiver 不 包含 任何 用 户 界面 ,但 可 以 通过 启动 
Activity 或 者 Notification 通知 用 户 接收 到 重要 信息 。Notification 能 够 通过 多 种 方法 提 
示 用 户 , 包 括 闪 动 背景 灯 、 振 动 设备 ,发 出 声音 或 在 状态 栏 上 放置 一 个 持久 的 图 标 等 。 

Content provider 是 Android 系统 提供 的 一 种 标准 的 共享 数据 的 机 制 ,应 用 程序 可 
以 通过 Content provider 访问 其 他 应 用 程序 的 私有 数据 。 私 有 数据 可 以 是 存储 在 文件 系 
统 中 的 文件 ,也 可 以 是 SQLite 中 的 数据 库 。Android 系统 内 部 也 提供 一 些 内 置 的 
Content provider, 能 够 为 应 用 程序 提供 重要 的 数据 信息 ,例如 联系 人 信息 和 通话 记录 等 。 
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Android 系统 通过 组 件 机 制 , 有 效 降 低 了 应 用 程序 的 耦合 性 ,使 向 其 他 应 用 程序 共享 
私有 数据 (Content provider) 和 调用 其 他 程序 的 私有 模块 (Service) 成 为 可 能 。 

所 有 Android 组 件 都 具有 自己 的 生命 周期 , 称 为 组 件 声明 周期 ,是 从 组 件 建立 到 组 
件 销毁 的 整个 过 程 。 在 这 个 过 程 中 ,组 件 会 在 可 见 、 不 可 见 、 活 动 、 非 活动 等 状态 中 不 断 
变化 ,下 一 节 将 主要 对 Activity 的 生命 周期 进行 详细 介绍 。 
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Activity 生命 周期 指 Activity 从 启动 到 销毁 的 过 程 。 在 这 个 过 程 中 ,Activity 一 般 表 
现 为 4 种 状态 ,分 别 是 活动 状态 、 暂 停 状 态 、 停 止 状态 和 非 活动 状 态 。 

CD 活动 状态 , 当 Activity 在 用 户 界面 中 处 于 最 上 层 ,完全 能 被 用 户 看 到 ,能 够 与 用 户 
进行 交互 , 则 这 个 Activity 处 于 活动 状态 。 

@ 暂停 状态 , 当 Activity 在 界面 上 被 部 分 遮挡 ,该 Activity 不 再 处 于 用 户 界面 的 最 
上 层 , 且 不 能 够 与 用 户 进行 交互 , 则 这 个 Activity 处 于 暂停 状态 。 

@ 停止 状态 , 当 Activity 在 界面 上 完全 不 能 被 用 户 看 到 ,也 就 是 说 这 个 Activity 被 
其 他 Activity 全 部 遮挡 , 则 这 个 Activity 处 于 停止 状态 。 

Ф 非 活动 状态 ,活动 状态 .暂停 状态 和 停止 状态 是 Activity 的 主要 状态 ,不 在 以 上 三 
种 状态 下 Activity 的 则 处 于 非 活动 状态 。 

Activity 的 4 种 状态 的 变换 关系 如 图 4.2 所 示 。Activity 启动 后 处 于 活动 状态 ,此 时 
的 Activity 位 于 界面 的 最 上 层 ,是 与 用 户 正 在 进行 交互 的 组 件 ,因此 Android 系统 会 努力 
保证 处 于 活动 状态 Activity 的 资源 需求 ,资源 紧张 时 可 终止 其 他 状态 的 Activity; 如 果 用 
户 启 动 了 新 的 Activity ,部 分 遮挡 了 当前 的 Activity, 或 新 的 Activity 是 半 透 明 的 , 则 当前 
的 Activity 转换 为 暂停 状态 ,Android 系统 仅 在 为 处 于 活动 状态 的 Activity 释放 资源 时 
才 终 止 处 于 暂停 状态 的 Activity; 如 果 用 户 启 动 新 的 Activity 完全 遮挡 了 当前 的 
Activity, 则 当前 的 Activity 转变 为 停止 状态 ,停止 状态 的 Activity 将 优先 被 终止 ;活动 状 
态 的 Activity 被 用 户 关 闭 后 ,以 及 暂停 状态 或 停止 状态 的 Activity 被 系统 终止 后 ， 
Activity 便 进 入 了 非 活动 状态 。 


| ”活动 状态 px 停止 状态 — 非 活动 状态 | 


图 4. 2 Activity 状态 变换 图 


为 能 够 更 好 地 理解 Activity 的 生命 周期 ,还 需要 对 Activity 栈 做 一 下 简要 介绍 。 
Activity 栈 保 存 了 已 经 启动 且 没 有 终止 的 所 有 Activity, 并 遵循 “后 进 先 出 ”的 规则 。 如 
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图 4. 3 所 示 , 栈 顶 的 Activity 处 于 活动 状态 , 除 栈 顶 以 外 的 其 他 Activity 处 于 暂停 状态 或 

停止 状态 ,而 被 终止 的 Activity 或 已 经 出 栈 的 Activity 则 不 在 栈 内 。 

Activity 
m 出 栈 

活动 状态 { Activity E— ——3 Activity 非 活动 状态 


Activity 
Activity 


暂停 状态 或 
停止 状态 


终止 
Activity F—— Activity 非 活动 状态 
Activity 栈 释放 资源 


4.3 Activity Ж 


Activity 的 状态 与 其 在 Activity 栈 的 位 置 有 着 密切 的 关系 ,不 仅 如 此 ,Android 系统 
在 资源 不 足 时 ,也 是 通过 Activity 栈 来 选择 哪些 Activity 是 可 以 被 终止 的 。 一 般 来 讲 ， 
Android 系统 会 优先 终止 处 于 停止 状态 , 且 位 置 靠近 栈 底 的 Activity, 因 为 这 些 Activity 
被 用 户 再 次 调用 的 机 会 最 小 , 且 在 界面 上 用 户 是 看 不 到 的 。 
随 着 用 户 在 界面 进行 的 操作 ,以 及 Android 系统 对 资源 的 动态 管理 ,Activity 不 断 变 
化 其 在 Activity 栈 中 的 位 置 ,状态 也 不 断 在 4 种 状态 间 转 变 。 随 着 Activity 自身 状态 的 
变化 ,Android 系统 会 调用 不 同 的 事件 回调 函数 ,开发 人 员 在 事件 回调 函数 中 添加 代码 ， 
就 可 以 在 Activity 状态 变化 时 完成 适当 的 工作 。 
下 面 的 代码 给 出 了 Activity 的 主要 事件 回调 函数 : 
Public class MyActivity extends Activity { 
protected void onCreate (Bundle savedInstanceState); 


protected void onStart () ; 
protected void onRestart () ; 


protected void onPause () 7 
protected void onStop () ; 


1. 

2 

3 

4 

5 protected void onResume|(); 
6 

+ 

8 protected void onDestroy () ; 
9 


) 


这 些 事 件 回调 函数 何 时 被 调用 ,具体 用 途 是 什么 ,以 及 是 否 可 以 被 Android 系统 终 
止 ,可 以 参考 表 4.1. 
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Ж 4.1 Activity 生命 周期 的 事件 回调 函数 


函 数 是 否 可 终止 说 明 
ety 否 Activity 启动 后 第 一 个 被 调用 的 函数 ,常用 来 进行 Activity 的 初始 化 ， 
ў 例如 创建 View、 绑 定数 据 或 恢复 信息 等 
onStart() T 当 Activity 显示 在 屏幕 上 时 ,该 函数 被 调用 
onRestart() 否 `á Activity 从 停止 状态 进入 活动 状态 前 ,调用 该 函数 
a 当 Activity 可 以 接收 用 户 输入 时 ,该 函数 被 调用 。 此 时 的 Activity 位 
idis É + Activity 栈 的 栈 顶 
当 Activity 进入 暂停 状态 时 ,该 函数 被 调用 。 主 要 用 来 保存 持久 数据 、 
onPause() f 关闭 动画 、 释 放 CPU 资源 等 。 该 函数 中 的 代码 必须 简短 ,因为 男 一 个 
Activity 必须 等 待 该 函数 执行 完毕 后 才能 显示 在 界面 上 
onStop() 是 当 Activity 不 对 用 户 可 见 后 ,该 函数 被 调用 ,Activity 进入 停止 状态 
在 Activity 被 终止 前 , 即 进入 非 活动 状态 前 ,该 函数 被 调用 。 有 两 种 情 
onDestroy() 是 况 该 函数 会 被 调用 : 程序 主动 调用 finishO р Zi; @ 程 序 被 Android 
系统 终结 


除了 Activity 生命 周期 的 事件 回调 函数 以 外 ,还 有 onRestoreInstanceState ( ) 和 
onSaveInstanceState() 两 个 函数 经 常会 被 使 用 ,用 于 保存 和 恢复 Activity 的 界面 临时 信 
息 , 如 用 户 在 界面 中 输入 的 数据 或 选择 的 内 容 等 ,而 onPause() 一 般 被 用 来 保存 界面 的 持 
久 信息 。 

onSavelInstanceState() 和 onRestoreInstanceState O 函数 不 属于 生命 周期 的 事件 回 
调 函 数 ,onSaveInstanceState() 在 Activity 被 暂时 停止 时 (被 其 他 程序 中 断 或 锁 屏 ) 被 调 
用 ,而 Activity 在 完全 关闭 时 (调用 finish O 函数 ) 则 不 会 被 调用 。 当 暂停 的 Activity 被 
恢复 时 ,系统 会 调用 onRestoreInstanceStateO FR 2. 

举 个 例子 说 明 这 两 个 函数 是 如 何 被 调用 的 。 如 用 户 启动 Activity A, 然 后 直接 又 启动 
Activity B, 这 时 系统 需要 停止 Activity A, 则 会 调用 Activity A 的 onSaveInstanceState() 
来 保存 Activity A 的 界面 临时 信息 。 当 用 户主 动 关 闭 Activity B 时 , Activity B 的 
onSaveInstanceState() 不 会 被 调用 ,因为 是 用 户主 动 关闭 Activity B 而 不 是 系统 暂停 的 ,所 以 
当 Activity А 重新 显示 在 屏幕 上 后 ,Activity A 可 以 选择 调用 onRestoreInstanceState( ) 用 以 
恢复 之 前 保存 的 Activity A 的 状态 信息 。 

Activity 状态 保存 和 恢复 函数 onRestoreInstanceState() 和 onSaveInstanceState() 的 
说 明 参 见 表 4.2. 

表 4.2 Activity 状态 保存 /恢复 的 事件 回调 函数 
[3 E 说 HB 


onSavelInstanceState() 暂停 或 停止 Activity 前 调用 该 函数 ,用 以 保存 Activity 的 临时 状态 信息 
onRestoreInstanceState() | 恢复 onSaveInstanceState() 保 存 的 Activity 状态 信息 


onSaveInstanceState() 函 数 会 将 界面 临时 信息 保存 在 Bundle 中 ,onCreate( O 函数 和 
onRestoreInstanceState ( ) 函数 都 可 以 恢复 这 些 保存 的 信息 。 一 般 简化 的 做 法 是 在 
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onCreateC ) 函数 中 恢复 保存 的 信息 ,但 有 些 特殊 的 情况 下 还 是 需要 使 用 
onRestoreInstanceState() 函数 恢复 保存 信息 ,如 必须 在 界面 完全 初始 化 完毕 后 才能 进行 
的 操作 ,或 需要 由 子 类 来 确定 是 否 采用 默认 设置 等 。 

在 Activity 的 生命 周期 中 ,并 不 是 所 有 的 事件 回调 函数 都 会 被 执行 ,但 如 果 被 调用 
则 会 遵循 图 4. 4 描述 的 调用 顺序 。 


(1) (3) (7) 


onCreate onRestore onPause onSave 
InstanceState InstanceState 


onRestart. 


活动 生命 周期 
可 视 生 命 周期 


全 生命 周期 


4.4 Activity 事件 回调 函数 的 调用 顺序 


从 图 4.4 中 可 知 ,Activity 的 生命 周期 可 分 为 完全 生命 周期 .可 视 生命 周期 和 活动 生 
命 周 期 。 每 种 生命 周期 中 包含 不 同 的 事件 回调 函数 。 

完全 生命 周期 开 是 从 Activity 建立 到 销毁 的 全 部 过 程 , 始 于 onCreate(), 结 束 于 
onDestroy()。 一 般 情 况 下 ,使 用 者 在 onCreate() 中 初始 化 Activity 所 能 使 用 的 全 局 资源 
和 状态 ,并 在 onDestroy() 中 释放 这 些 资源 。 例 如 , Activity 中 使 用 后 台 线 程 , 则 需要 在 
onCreate() 中 创建 线程 ,在 onDestroy() 中 停止 并 销毁 线程 。 在 一 些 极端 的 情况 下 ， 
Android 系统 会 不 调用 onDestroy() 函 数 ,而 直接 终止 进程 。 

可 视 生 命 周期 是 Activity 在 界面 上 从 可 见 到 不 可 见 的 过 程 ,开始 于 onStart() ,结束 
于 onStop()。onStart() 一 般 用 来 初始 化 或 启动 与 更 新 界面 相关 的 资源 。onStop() 一 般 
用 来 暂停 或 停止 一 切 与 更 新 用 户 界面 相关 的 线程 .计时 器 或 Service 等 ,因为 在 调用 
onStop( ) 后 , Activity 对 用 户 不 再 可 见 ,更 新 用 户 界面 也 就 没有 任何 实际 意义 。 
onRestart() 函数 在 onSart() 前 被 调用 ,用 来 在 Activity 从 不 可 见 变 为 可 见 的 过 程 中 , 进 
行 一 些 特定 的 处 理 过 程 。 因 为 Activity 不 断 从 可 见 变 为 不 可 见 , 再 从 不 可 见 变 为 可 见 ， 
所 以 onStart() 和 onStop() 会 被 多 次 调用 。 另 外 ,onStart() 和 onStop() 也 经 常 被 用 来 注 
册 和 注销 BroadcastReceiver. 例如 使 用 者 可 以 在 onStart () 中 注册 一 个 
BroadcastReceiver, 用 来 监视 某 些 重要 的 广播 消息 ,并 使 用 这 些 消息 更 新 用 户 界 面 中 的 相 
关内 容 , 并 可 以 在 onStop() 中 注销 BroadcastReceiver。 

活动 生命 周期 是 Activity 在 屏幕 的 最 上 层 , 并 能 够 与 用 户 进行 交互 的 阶段 ,开始 于 
onResume() ,结束 于 onPause()。 因 为 在 Activity 的 状态 变换 过 程 中 onResume() 和 
onPause() 经 常 被 调用 ,因此 这 两 个 函数 中 应 使 用 简单 .高 效 的 代码 。 

ER 4. 1 中 “是 否 可 终止 ?表示 事件 回调 函数 在 执行 过 程 中 或 返回 后 是 否 可 以 被 
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Android 系统 终止 ,否定 答案 表示 在 函数 从 被 调用 后 ,直到 函数 返回 前 ,Android 系统 不 
能 够 终止 该 进程 ;肯定 答案 表示 在 当前 的 函数 返回 前 ,Android 系统 随时 可 以 终止 该 

从 图 4.4 的 Activity 事件 回调 函数 的 调用 顺序 上 分 析 ,onStop() 是 第 一 个 被 标识 为 
“可 终止 ?的 函数 ,因此 在 onStop() 和 onDestroy() 函 数 的 执行 过 程 中 随时 能 被 Android 
系统 终止 。 因 此 ,onPause() 常 用 来 保存 持久 数据 ,如 界面 上 的 用 户 输入 信息 等 。 很 多 时 
候 使 用 者 不 清楚 何 时 该 使 用 onPause() , 何 时 该 使 用 onSaveInstanceState() . P3 2g Wj Af РА 
数 都 可 以 用 来 保存 界面 的 用 户 输入 数据 。 其 主要 区 别 在 于 这 两 个 函数 保存 数据 的 性 质 
和 方法 不 同 : onPause() 一 般 用 于 保存 持久 性 数据 ,并 将 数据 保存 在 存储 设备 上 的 文件 系 
统 或 数据 库 系统 中 ;而 onSaveInstanceState() 主要 用 来 保存 动态 的 状态 信息 ,信息 一 般 
保存 在 Bundle 中 。Bundle 是 能 够 保存 多 种 格式 数据 的 对 象 ,在 onSaveInstanceState() 
保存 在 Bundle 中 的 数据 ,系统 在 调用 onRestoreInstanceState() 和 onCreate() 时 会 利用 
Bundle 将 数据 传递 给 函数 。 

为 了 能 够 更 好 地 理解 Activity 事件 回调 函数 的 调用 顺序 ,下 面 以 ActivityLifeCycle 
示例 来 进行 说 明 , ActivityLifeCycle 示例 的 运行 
界面 如 图 4.5 所 示 。 "Tee 

下 面 给 出 ActivityLifeCycleActivity. java XC 
件 的 全 部 代码 。 


package edu.hrbeu.ActivityLifeCycle; 


import android.app.Activity; В 4.5  ActivityLifeCycle 示例 用 户 界 面 
import android.os.Bundle; 


public class ActivityLifeCycleActivity extends Activity ( 


1 
2 
3 
4 
5 import android.util.Log; 
6 
7 
8 private static String TAG- "LIFTCYCLE"; 
9 


// 完 全 生命 周期 开始 时 被 调用 ,初始 化 activity a) 
10 G Override 
11 public void onCreate (Bundle savedInstancesState) { 
12 super.onCreate (savedInstanceState); 
13 setContentView (R.layout.main); 
14 Log.i (TAG, "(1) опСгеаѓе ()"); 
15 
16 // 定 义 按钮 和 按钮 监听 函数 ,通过 用 户 点 击 按钮 调用 finish () 函 数 结束 程序 
17 Button button= (Button) findViewById(R.id.btn finish); [s] Fç 
18 button.setOnClickListener (new View.OnClickListener () { 
19 public void onClick (View view) { 
20 finish(); 
21 } 
22 n; 


24 
25 
26 
27 
28 
29 
30 
э 
з2 
зз 
з4 
35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
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// 可 视 生 命 周 期 开始 时 被 调用 ,对 用 户 界 面 进行 必要 的 更 改 
@Override 
public void onStart () { 

super.onStart () ; 

Log.i(TAG, "(2)onStart()"); 


// 在 onstart () 后 被 调用 ,用 于 恢复 onsaveInstancestate() 保 存 的 用 户 界面 信息 
@ Override 
public void onRestoreInstanceState (Bundle savedInstancesState) { 
super.onRestoreInstanceState (savedInstanceState); 
Log.i (TAG, "(3)onRestoreInstanceState ()"); 


// 在 活动 生命 周期 开始 时 被 调用 ,恢复 被 on Pause () 停 止 的 用 于 界面 更 新 的 资源 
@ Override 
public void onResume () { 

super.onResume () ; 

Log.i (TAG, " (4) onResume ()") ; 


//{Е onPause () 后 被 调用 ,保存 界面 临时 信息 

@ Override 

public void onSaveInstanceState (Bundle savedInstancesState) { 
super.onSaveInstanceState (savedInstanceState); 
Log.i(TAG, "(5)onSaveInstanceState ()"); 


// 在 重新 进入 可 视 生 命 周期 前 被 调用 , 载 入 界面 所 需要 的 更 改 信息 
@override 
public void onRestart () { 

super.onRestart () ; 

Log.i(TAG, "(6)onRestart ()"); 


// 在 活动 生命 周期 结束 时 被 调用 ,用 来 保存 持久 的 数据 或 释放 占用 的 资源 
@Override 
public void onPause () { 

super.onPause () ; 

Log.i(TAG, "(7)onPause()"); 


(2) 


(3) 


(4) 


(5) 


(6) 


(7) 
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67 // 在 可 视 生 命 周 期 结束 时 被 调用 ,用 来 释放 占用 的 资源 (8) 
68 @override 

69 public void onStop () { 

70 super.onStop(); 

qu Log.i(TAG, "(8)onStop()"); 

72 } 

13 

74 // 在 完全 生命 周期 结束 时 被 调用 ,释放 资源 ,包括 线程 .数据 连接 等 (9) 
75 @ Override 

76 public void onDestroy () { 

77 super.onDestroy () ; 

78 Log.i (TAG, "(9)onDestroy () ") ; 

79 } 

80 } 


上 面 的 程序 主要 通过 在 生命 周期 函数 中 添加 “日 志 点 ”的 方法 进行 调试 ,程序 的 运行 
结果 将 会 显示 在 LogCat 中 。LogCat 和 “日 志 点 ”的 使 用 方法 ,请 参考 4.4.1 45, HTE 
示 结 果 易 于 观察 和 分 析 , 在 LogCat 设置 过 滤器 Life, 过 滤器 的 条 件 为 “标签 = 
LIFTCYCLE”。 日 志 信息 中 的 数字 标识 与 图 4. 4 的 函数 编号 一 致 ,因此 ,可 以 参考 图 4.4 
阅读 下 面 内 容 。 

(1) 完全 生命 周期 

为 了 观察 Activity 从 启动 到 关闭 所 调用 的 全 部 生命 周期 函数 的 顺序 ,首先 正常 启 
ActivityLifeCycle, 然 后 点 击 用 户 界面 的 “结束 程序 ”按钮 关闭 程序 。LogCat 的 输出 结 
如 图 4.6 所 示 。 


动 
果 


Level Time PID Application Tag Text 


(I 10-21 01 edu.hrbeu.ActivityLifeCycle LIFECYCLE (1) onCreate() 
I 10-2: edu.hrbeu.ActivityLifeCycle LIFECYCLE (2) onStart() 
I 10-21 01:13:12.947 578 — edu.hrbeu.ActivityLifeCycle LIFECYCLE (4) onResume() 
I 10-21 01:17:23.328 578 edu.hrbeu.ActivityLifeCycle LIFECYCLE (7) onPause() 
1 10-21 01:17:25.817 578  edu.hrbeu.ActivityLifeCycle LIFECYCLE — (8) onStop() 
I 10-21 01:17:25.817 578  edu.hrbeu.ActivityLifeCycle LIFECYCLE (9) onDestroy() 


图 4.6 完全 生命 周期 的 LogCat 输出 


从 图 4.6 可 以 得 知 , 函 数 调用 顺序 如 下 : (1) опСгеате—> (2) onStart- (4) onResume 
—-*-(7)onPause-*(8)onStop-* (9)onDestroy., 

TE Activity 启动 时 ,系统 首先 调用 onCreate O 函数 分 配 资源 , 然 调 用 onStart O $ 
Activity 显示 在 屏幕 上 ,之 后 调用 onResume() 获 取 屏 幕 焦点 ,使 Activity 能 够 接收 用 户 
的 输入 ,这 时 用 户 就 能 够 正常 使 用 这 个 Android 程序 了 。 

用 户 点 击 “ 结 束 程序 ”按钮 ,会 导致 Activity 关闭 ,系统 会 相继 调用 onPause()、 
onStop() 和 onDestroy O ,释放 资源 并 销毁 进程 。 因 为 Activity 关闭 后 .除非 用 户 重新 启 
动 应 用 程序 ,否则 这 个 Activity 不 会 在 出 现在 屏幕 上 ,因此 系统 直接 调用 onDestroy O #5 
毁 了 进程 , 且 没 有 调用 onSaveInstanceState() 函数 来 保存 Acitivity 状态 。 
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(2) 可 视 生 命 周期 

在 Activity 启动 后 ,如 果 启 动 其 他 程序 , 原 有 的 Activity 会 被 新 启动 程序 的 Activity 
完全 遮挡 ,因此 原 有 Activity 会 进入 停止 状态 。 如 果 将 新 启动 的 程序 关闭 , 则 原 有 
Activity 从 停止 状态 恢复 到 活动 状态 。 

为 了 能 够 分 析 上 述 状 态 转换 过 程 中 的 函数 调用 顺序 ,首先 正常 启动 
ActivityLifeCycle, 然 后 通过 ”拨号 键 ?启动 内 置 的 拨号 程序 ,再 通过 * 回 退 键 ? 退 出 拨号 程 
序 , 使 ActivityLifeCycle 重新 显示 在 屏幕 中 。LogCat 的 输出 结果 如 图 4.7 所 示 。 


Level Time Application 


10-22 06 946 567 edu.h 


І 
І 
І 
І 
І 
І 
І 
І 
І 


(2) onStart() 


(4) onResume() 


4.7 可 视 生 命 周期 的 LogCat 输出 


从 图 4.7 可 以 得 知 , 函 数 调 用 顺序 如 下 : (1)опСгеате—> (2) оп$їагї—> (4) onResume 
一 一 (7) onPause 一 (5) onSaveInstanceState 一 (8) onStop > — (6) onRestart > (2) 
onŠtart>*(4)onResume, 

Activity 启动 时 的 函数 调用 顺序 仍 为 (1) 一 (2) 一 (4), 当 内 置 的 拨号 程序 被 启动 时 ， 
原 有 的 Activity 被 完全 覆盖 ,系统 首先 调用 
onPause( ) 函数 ,然后 调用 onSavelnstanceState () 
函数 保存 Activity 状态 ;最 后 调用 onStop() ,停止 
对 不 可 见 Activity 的 更 新 。 

在 用 户 关闭 拨号 程序 后 ,系统 调用 onRestart() ан 
更 新 信息 ,然后 调用 onStart() 和 onResume() 重 新 | or 
显示 Activity ,并 接收 用 户 交互 。 Enable OpenGLtraces 

Android 系统 虽然 调用 了 onSaveInstanceState() | "°° 
保存 Activity 的 状态 ,因为 Activity 并 没有 被 销毁 ， | aps 
所 以 没有 必要 调用 onRestoreInstanceState() 恢 复 оор асна IC 
保存 的 Activity 状态 。 в 

如 果 用 户 在 Dev Tools— Developer options—* | Background process limit 
Dont't keep activities 开启 该 选项 ,如 图 4.8 所 示 ， хаш 
被 其 他 程序 遮挡 的 Activity 会 被 立即 终止 ,这样 被 о ГЕ D 
JE PARI Activity 重新 显示 在 屏幕 上 时 ,系统 会 调用 “eerps 
onRestorelnstanceState( ) 恢复 Activity 销毁 前 的 4.8 开启 IDA 选项 
状态 。 

从 图 4.9 可 以 得 知 ,函数 调用 顺序 如 下 : (1)onCreate 一 (2)onStart 一 (4)onResume 


ИГҮ 


Developer options 


on 
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一 一 (7)onPause 一 (5)onSaveInstanceState 一 (8)onStop >— (1)onCreate—>(2)onStart 


一 (3)onRestoreInstanceState 一 (4)onResume。 


level Time PID Application Tag Text 


I 10-22 07:13:33.476 772 edu.hrbeu.ActivityLifeCycle LIFECYCLE (1) onCreate() 

I 10-22 07:13:33.476 772 edu.hrbeu.ActivityLifeCycle LIFECYCLE (2) onStart() 

I 10-22 07:13:33.486 772 edu.hrbeu.ActivityLifeCycle LIFECYCLE (4) onResume() 

I 10-22 07:13:47.946 772 edu. tivityLifeCycle LIFECYCLE — (7) onPause() 

I 10-22 07:13:50.966 772 edu. LifeCycle LIFECYCLE (5) onSaveInstanceState() 

I 10-22 07:13:50.966 772  edu.hri ityLifeCycle LIFECYCLE (8) onStop() 

I 10-22 07:14:00.287 833 edu.hm vityLifeCycle LIFECYCLE — (1) onCreate() 

I 10-22 07:14:00.296 833 — edu.hrbeu.ActivityLifeCycle LIFECYCLE (2) onStart() 

I 10-22 07:14:00.327 833  edu.hrbeu.ActivityLifeCycle LIFECYCLE (3) onRestore Instance: State () 
1 10-2207:14:00.336 8 edu.hrbeu.ActivityLifeCycle (4) onResume () 


4.9 开启 ША 的 可 视 生命 周期 LogCat 输出 


IDA 未 开启 前 ,用 户 点 击 “ 回 退 ? 按 钮 后 的 函数 调用 顺序 是 (6) 一 (2) 一 (4) ,开启 IDA 
后 的 函数 调用 顺序 是 (1)~(2)-(3)- 一 (4)。 由 此 可 见 开启 IDA. 导致 Android 系统 在 用 
户 打开 其 他 程序 是 销毁 了 原来 已 经 打开 的 Activity, 这 个 被 销毁 的 Activity 重新 出 现在 
用 户 的 屏幕 上 前 ,系统 额外 调用 了 onCreate() 和 onRestoreInstanceState() 函 数 , 用 以 恢 
复 Activity 在 销毁 前 所 保存 的 数据 。 
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在 Android 程序 开发 过 程 中 ,出 现 错误 (Bug) 是 不 可 避免 的 事情 。 一 般 情况 下 ,语法 
错误 会 被 集成 开发 环境 检测 到 ,并 提示 使 用 者 错误 的 位 置 以 及 修改 方法 。 但 逻辑 错误 就 
不 那么 容易 发 现 了 ,通常 只 有 将 程序 在 模拟 器 或 硬件 设备 上 运行 才能 够 发 现 。 逮 辑 错误 
的 定位 和 分 析 是 件 困难 的 事情 ,尤其 对 于 代码 量 较 大 且 结 构 复 杂 的 应 用 程序 , 仅 赁 直觉 
很 难 快速 找到 并 解决 问题 。 因 此 ,Android 系统 提供 了 几 种 调试 工具 ,用 于 定位 、 分 析 及 
修复 程序 中 出 现 的 错误 ,这些 工 具 包括 LogCat 和 DevTools 。 
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LogCat 是 用 来 获取 系统 日 志 信 息 的 工具 ,可 以 显示 在 Eclipse 集成 开发 环境 中 。 
LogCat 能 够 捕获 的 信息 包括 Dalvik 虚拟 机 产生 的 信息 .进程 信息 .ActivityManager fii 
息 、PackagerManager 信息 、Homeloader 信息 、WindowsManager 信息 、Android 运行 时 
信息 和 应 用 程序 信息 等 。 在 Eclipse 的 默认 开发 模式 下 没有 LogCat 的 显示 页 ,用 户 可 以 
使 用 Window 一 Show View— Other 打开 Show View 的 选择 菜单 ,然后 在 Andoird— 
LogCat 中 选择 LogCat, 如 图 4. 10 所 示 。 

这 样 ,LogCat 便 显示 在 Eclipse 的 下 方 区 域 . 如 图 4. 11 所 示 。LogCat 的 右上 方 的 
5 个 字母 [V]、LD]、[LI、LCW] 和 [E], 表 示 5 种 不 同类 型 的 日 志 信 息 , 分 别 是 详细 
(Verbose) 信 息 ,调试 (Debug) 信 息 、 通 告 (Info) 信 息 、 警 告 (Warn) 和 错误 (Error) 信 息 。 
不 同类 型 日 志 信息 的 级 别 是 不 相同 的 ,级 别 最 高 的 是 错误 信息 ,其 次 是 警告 信息 ,然后 是 
通知 信息 和 调试 信息 ,级别 最 低 的 是 详细 信息 。 在 LogCat 中 ,用 户 可 以 通过 5 个 字母 图 
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type filter text 


> |2 General 

4 @ Android 
Allocation Tracker 
8 Devices 
@ Emulator Control 
ifi File Explorer 
@ Heap 
"s$ Layout View 
EZ Lint Warnings 
YD LogCat 
ii LogCat (deprecated) 
< Network Statistics 
A Pixel Perfect 


Ф тыз] nasta lonnan 


ок К: 


4.10 Show View 中 选择 LogCat 


标 选择 显示 的 信息 类 型 ,同时 级 别 比 选择 类 型 高 的 信息 也 可 以 在 LogCat 中 显示 ,但 级 别 
低 于 选 定 的 信息 则 会 被 忽略 掉 。 


Saved Filters 


ll message (no fitors) 


eduhrbeulogCatGedonr | =т= tet 


10-20 19:96:15.354 1170 = 
10-20 13:36:15.393 1170 


um pee 
1170 — com.android.development 


es system process 


图 4.11 Eclipse 中 的 LogCat 


即使 用 户 指定 了 所 显示 日 志 信息 的 级 别 ,仍然 会 产生 很 多 日 志 信息 ,很 容易 让 用 户 
不 知 所 措 。LogCat 还 提供 了 “过 滤 ” 功 能 ,在 右上 角 的 十 号 和 一 号 分 别 是 添加 和 删除 过 
滤器 。 用 户 可 以 根据 日 志 信 息 的 标签 (Tag)、 产 生日 志 的 进程 编号 (Pid) 或 信息 等 级 
(Level) ,对 显示 的 日 志 内 容 进 行 过 滤 。 

在 Android 程序 调试 过 程 中 ,首先 需要 引入 android. util. Log 包 , 然 后 使 用 Log. vO, 
Log. dO „Log. iO.Log. wO 和 Log. e() 五 个 函数 在 程序 中 设置 日 志 点 。 每 当 程序 运行 
到 日 志 点 时 ,应 用 程序 的 日 志 信息 便 被 发 送 到 LogCat 中 ,使 用 者 可 以 根据 日 志 点 信息 是 
否 与 预期 的 内 容 一 致 ,判断 程序 是 否 存 在 错误 。 之 所 以 使 用 5 个 不 同 的 函数 产生 日 志 ， 
主要 是 为 了 区 分 日 志 信息 的 类 型 ,其 中 ,Log. v() 用 来 记录 详细 信息 ,Log. d() 用 来 记录 调 
试 信息 ,Log. i() 用 来 记录 通告 信息 ,Log. w() 用 来 记录 警告 信息 .Log.e() 用 来 记录 通 错 
误 信 息 。 

在 下 面 的 程序 中 ,演示 了 Log 类 的 具体 使 用 方法 。 
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package edu.hrbeu.LogCat; 


import android.app.Activity; 
import android.os.Bundle; 


import android.util.Log; 


public class LogCatActivity extends Activity { 
final static String TAG- "LOGCAT"; 
@override 
public void onCreate (Bundle savedInstanceState)( 
super.onCreate (savedInstanceState); 


setContentView (R.layout.main); 


Log.v (TAG, "Verbose"); 
Log.d (TAG, "Debug") ; 
Log.i (TAG, Info"); 
Log.w (TAG, "Warn"); 
Log.e (ТАС, "Error"); 


} 


为 了 使 用 Log 类 中 的 函数 ,首先 在 程序 第 5 行 引入 android. util. Log 包 ; 然 后 在 第 
8 行 定 义 标签 ,标签 帮助 用 户 在 LogCat 中 找到 目标 程序 生成 的 日 志 信息 ,同时 也 能 够 利 
用 标签 对 日 志 进 行 过 滤 ;第 14 行 记 录 一 个 详细 信息 ,Log. vO 函数 的 第 一 个 参数 是 日 志 
的 标签 ,第 二 个 参数 是 实际 的 信息 内 容 ; 第 15 行 到 第 18 行 分 别 产 生 了 调试 信息 .通告 信 
By .警告 信息 和 错误 信息 。 

程序 运行 后 ,LogCat 捕获 得 到 应 用 程序 发 送 的 日 志 信息 ,显示 结果 如 图 4. 12 所 示 。 
在 LogCat 中 显示 了 标签 为 LOGCAT 的 日 志 信息 共 5 条 ,并 以 不 同 颜色 加 以 显示 。 可 
见 ,LogCat 对 不 同类 型 的 信息 使 用 了 不 同 的 颜色 加 以 区 别 。 


Seved Fiters «km ЫИ... for messages. Асер Java regexec. Praf with pid, apps, tag: or text to limit «cope. verbose +) EM BL [ID] 


All messages [no filter 


eduhrbeulogtal(Se] Tre PD — Appkaion Te Tet 


аз-аз Dona ne a mea oe 
10-20 13 пег 
10-20 13 na 


12-20 аз. 2182 


10-20 13:53:07.726 — 2102 lu.hrbeu.LogCaz ira110€ 014112) lator without GPU emulation detected. 


4.12 LogCat 工程 的 运行 结果 


如 果 能 够 使 用 LogCat 的 过 滤器 , 则 可 以 使 显示 的 结果 更 加 清晰 。 下 面 使 用 在 
LogCat 右 侧 的 十 号 ,添加 一 个 名 为 LogcatFilter 的 过 滤器 ,并 设置 过 滤 条 件 为 “标签 一 
LOGCAT” ,具体 设 置 方法 如 图 4. 13 所 示 。 

过 滤器 设置 好 后 ,LogcatFilter 过 滤 后 的 日 志 信 息 如 图 4. 14 所 示 。 以 后 ,无 论 什 么 


Logcat Message Filter Settings | 
Filter logcat messages by the source's tag, pid or minimum log level. 
Empty fields will match all messages. 


Filter Name: LogcatFilter 


by Log Tag: LOGCAT 
by Log Message: 
by PID: 
by Application Name: 
by Log Level: [verbose т 


® Сок] m) 


图 4.13  LogCat 过 滤器 


类 型 的 日 志 信息 ,属于 哪 一 个 进程 ,只 要 标签 为 LOGCAT, 都 将 显示 在 LogcatFilter 区 
域内 。 


All messages (no filters) (34) 


edu hrbeu.LogCat (Session Filter) == 
Filter V — 10-20 13:53:07.324 


L. Time 


edu.hrbeu.LogCat 
10-20 13:53:07.334 — 2182 。 edu.hrbeu.logCat 
10-20 13:53:07.334 2 ^ edu.hrbeu.LogCat 


图 4.14  LogCat 过 滤 后 的 输入 结果 
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在 Android 模拟 器 中 ,内 置 了 一 个 用 于 调试 和 测试 的 工具 DevTools。DevTools 包 
括 了 一 系列 用 户 各 种 用 途 的 小 工具 ,包括 AccountsTester, Bad Behavior, Configuration, 
Connectivity, Development Settings, Google Login Service, Instrumentation, Media 
Scanner, Package Browser, Pointer Location, Running processes, Sync Tester 和 
Terminal Emulator。 从 模拟 器 的 应 用 程序 列表 中 可 以 找到 启动 Dev Tools 的 图 标 ,启动 
DevTools 后 的 显示 界面 如 图 4. 15 所 示 。 

在 这 些 工具 里 ,经 常用 到 的 有 设置 调试 选项 的 Developer options ,查看 已 经 安装 程序 
包 的 Package Browser, 确定 触摸 点 位 置 的 Pointer Location, 查看 当前 运行 进程 的 
Running processes, 还 有 连接 底层 Linux 操作 系统 的 虚拟 终端 软件 Terminal Emulator。 
后 面 的 内 容 将 逐一 地 介绍 这 些 经 常 使 用 到 小 工具 的 功能 和 使 用 方法 。 


a» hdroid /z A 41 Z 3 Z (1 ЗА) 


Ça 322 Ça 日 323 


& Dev Tools 
oe 


Browser Calculator Developer options 


加 AccountsTester 


Camera Contacts 


Bad Behavior 


"m Cache Abuser 


Dev Tools Downloads 


$ = Configuration 


Galley Gestures B Connectivity 


Holo Spiral 


Search Settings 


Instrumentation 


4.15  DevTools 使 用 界面 


1. Developer options 


Developer options 中 包含 了 程序 调试 的 相关 选项 ,如 图 4. 16 所 示 。 


Ф 0 325 


Developer options 


on 


Take bug report 


Desktop backup password 
Desktop full backups aren't currently protected 


Stay awake 


Screen will never sleep while charging 


Always stay awake 
Screen will never sleep 


HDCP checking 
Use НОСР checking for DRM content only 


Enable Bluetocth HCI snoop log 
Capture all bluetooth HC! packets ina file 


Process Stats 


图 4.16 Developer options 


如 果 和 希望 启动 Developer options 中 某 项 功能 ,只 需要 点 击 功能 说 明 右 侧 的 选择 框 ， 
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出 现 绿色 的 对 号 (V ) 表 示 功 能 启用 。 功 能 启用 后 ,模拟 器 会 自动 保存 设置 ,即使 再 次 启 
动 模拟 器 用 户 的 选择 内 容 仍 会 存在 。Developer options 中 部 分 选项 的 具体 说 明 可 以 参 


考 表 4. 3。 
Ж 4.3 Developer options 选项 
я 项 说 明 
Stay awake 当 充 电 时 ,不 锁定 屏幕 
Always stay awake 一 直 不 自动 锁定 屏幕 


USB debugging 


不 启用 该 选项 就 不 能 使 用 adb 连接 设备 和 开发 环境 


Show Touches 


显示 触摸 操作 


Pointer Location 


指针 位 置 


Show CPU usage 


在 屏幕 顶端 显示 CPU 使 用 率 , 上 层 红线 显示 总 的 CPU 使 用 率 ,下 层 
绿 线 显示 当前 进程 的 CPU 使 用 率 


Show background 


应 用 程序 没有 Activity 显示 时 ,直接 显示 背景 面板 ,一 般 这 种 情况 仅 
在 调试 时 出 现 


Show sleep state on LED 


在 休眠 状态 下 开启 LED 


Windows Animation Scale 


窗口 动画 模式 


Transition Animation Scale 


渐变 动画 模式 


Don't keep activities 


Activity 进入 停止 状态 后 立即 销毁 ,用 于 测试 在 函数 
onSavelnstanceState( ) , onRestoreInstanceState ( ) 和 onCreate O Ф fff 


代码 


Background Process Limit 


2. РасКаре Browser 


限制 后 台 进 程 的 个 数 


Package Browser 是 Android 系统 中 的 程序 包 查看 工具 ,能 够 详细 显示 已 经 安装 到 
Android 系统 中 的 程序 信息 ,包括 包 名 称 、 应 用 程序 名 称 、 图 标 、 进 程 、 用 户 ID 版本、.apk 
文件 保存 位 置 和 数据 文件 保存 位 置 等 ,而 且 能 够 进一步 查看 应 用 程序 所 包含 Activity、 
Service, BroadcastReceiver 和 Provider 的 详细 信息 。 图 4. 17 是 在 Package Browser 中 查 
看 Android keyboard 程序 的 相关 信息 。 


3. Pointer Location 


Pointer Location 是 屏幕 点 位 置 查看 工具 ,能 够 显示 触摸 点 的 X 轴 坐 标 和 YY 轴 坐 标 。 
图 4. 18 是 Pointer Location 的 使 用 画面 。 


4. Running processes 


Running processes 能 够 查看 在 Android 系统 中 正在 运行 的 进程 ,并 能 查看 进程 的 详 
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Package Browser 


Package Summary 


9. Android Keyboard (A0SP) 


RESTART 


Android Live Wallpapers 


API Demos 


Activities 


ALLINONEACTIVITY 
LAUNCHACTIVITY 


Bluetoo EVENTINFOACTIVITY 


4.17 Package Browser 


图 4.18 Pointer Location 


细 信 息 ,包括 进程 名 称 和 进程 所 调用 的 程序 包 。 图 4. 19 是 Android 模拟 器 所 运行 进程 
的 列表 和 com. android. phone 进程 的 详细 信息 。 


Running processes 


android.process.acore 
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Е 


Ргосеѕѕ Information 


ате: 


android.process.media 


com.android.calendar 


com.android.deskclock 


com.android.development 


com.android.development_settings 


com.android.email 


com.android.exchange 


com.android.inputmethod.latin 


com.android.launcher3 


Packages in p 


图 4.19 Running processes 


5. Connectivity 


Connectivity 允许 用 户 控 
以 设置 Wifi 和 屏幕 锁定 界面 的 开启 与 关闭 的 周 
期 。 其 中 ENABLE WIFI 和 DISABLE WIFI 分 别 
是 控制 了 Wifi 的 开启 和 关闭 , START WIFI 
TOGGLE 和 STOP WIFI TOGGLE 是 WiFi 周 
期 性 开启 和 关闭 的 开关 ,Cycles done 后 面 的 数 
值 记 录 了 WiFi 开启 和 关闭 的 次 数 。 图 4. 20 是 
Connectivity 的 运行 界面 。 

6. Configuration 

Configuration 中 详细 列 出 了 Android 系统 的 
配置 信息 ,包括 屏幕 解析 度 .字体 缩放 比例 .屏幕 初 
双方 向 、 触 屏 类 型 .导航 、 本 地 语言 和 键盘 等 信息 ， 
如 图 4. 21 所 示 。 


7. Bad Behavior 


Bad Behavior 中 可 以 模拟 各 种 程序 崩 演 和 失 
去 响应 的 情况 ,如 主 程序 崩溃、 系统 服务 崩溃、 启动 


Service 时 失去 响应 和 启动 Activity 时 失去 响应 ax 


i| WiFi、 屏 幕 锁定 界面 .MMS 和 导航 的 开启 与 关闭 ,并 可 


Connectivity 


ENABLE WIFI — DISABLE WIFI 


START WIFI TOGGLE STOP WIFI TOGGLE 
ms): 120000 


ms): 120000 


START SCREEN TOGGLE STOP SCREEN TOGGLE 
): 120000 


12000 


START SCAN Disconnect 


15 


START TDLS STOP TDLS 


图 4.20 Connectivity 


等 。Bad Behavior 界面 如 图 4. 22 
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Configuration 


图 4.21 Configuration 


ZEE 


Bad Behavior 


CRASH THE MAIN APP THREAD 


CRASH AN AUXILIARY APP THREAD 


CRASH ТНЕ NATIVE PROCESS 


CRASH THE SYSTEM SERVER 


REPORT A WTF CONDITION 


ANR (STOP RESPONDING FOR 20 SECONDS) 


ANR STARTING AN ACTIVITY 


ANRRECEIVING A BROADCAST INTENT 


ANR STARTING A SERVICE 


SYSTEM ANR (IN ACTIVITYMANAGER) 


WEDGE SYSTEM (5 MINUTE SYSTEM ANR) 


4.22 Bad Behavior 


在 表 4.4 中 , 列 出 了 Bad Behavior 中 所 有 的 可 以 模拟 的 事件 ,并 对 每 个 事件 给 出 了 


简要 的 说 明 。 


表 4.4 Bad Behavior 选项 


选 项 


说 明 


CRASH THE MAIN APP THREAD 


应 用 程序 主线 程 崩 溃 


CRASH AN AUXILIARY APP THREAD 


应 用 程序 工作 线程 崩溃 


CRASH THE NATIVE PROCESS 本 地 进程 崩溃 
CRASH THE SYSTEM SERVER 系统 服务 器 崩溃 
REPORT А WTF CONDITION 报告 WTF 


ANR(STOP RESPONDING FOR 20 SECONDS) 


应 用 程序 无 响应 (Application Not Responding. 
ANR)20 秒 


ANR STARTING AN ACTIVITY 


启动 Activity 时 应 用 程序 无 响应 


ANR STARTING A BROADCAST INTENT 


启动 Intent 时 应 用 程序 无 响应 


ANR STARTING A SERVICE 


启动 Service 时 应 用 程序 无 响应 


SYSTEM ANR(IN ACTIVITY MANAGER) 


Activity 管理 器 级 别 АМЕ 


WEDGE SYSTEM(5 MINITE SYSTEM ANR) 


Wedge {Е 5 分 钟 内 无 响应 
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1. Ж Android 系统 前 台 进 程 . 可 见 进 程 .服务 进程 .后台 进程 和 空 进程 的 优先 级 排 
序 及 其 原因 。 

2. 简 述 Android 系统 的 4 种 基本 组 件 Activity, Service, BroadcaseReceiver 和 
ContentProvider 的 用 途 。 

3. 简 述 Activity 生命 周期 的 4 种 状态 ,以 及 状态 之 间 的 变换 关系 。 

4. 简 述 Activity 事件 回调 函数 的 作用 和 调用 顺序 。 


Android 用 户 界 面 


用 户 界 面 是 应 用 程序 开发 的 重要 组 成 部 分 ,决定 了 应 用 程序 是 否 美观 `. 易 用 。 通 过 
本 章 的 学 习 可 以 让 读者 熟悉 Android 用 户 界面 的 基本 开发 方法 ,了 解 在 Android 界面 开 
发 过 程 中 常见 的 界面 控件 .界面 布局 .菜单 和 界面 事件 的 使 用 方法 ,充分 理解 手机 应 用 程 
序 与 桌面 应 用 程序 在 用 户 界面 开发 上 的 不 同 与 相同 之 处 。 

本 章 学 习 目 标 : 

。 了 解 各 种 界面 控件 的 使 用 方法 ; 

。 掌握 各 种 界面 布局 的 特点 和 使 用 方法 ; 

。 掌握 选项 菜单 、 子 菜单 和 快捷 菜单 的 使 用 方法 ; 

。 掌握 操作 栏 和 Fragment 的 使 用 方法 ; 

。 掌握 按键 事件 和 触摸 事件 的 处 理 方法 。 
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用 户 界 面 (User Interface,UI) 是 系统 和 用 户 之 间 进 行 信息 交换 的 媒介 ,实现 信息 的 
内 部 形式 与 人 类 可 以 接收 形式 之 间 的 转换 。 最 古老 的 用 户 界 面 是 各 种 形式 的 文字 、 图 
JÉ .旗帜 和 手势 等 ,这 些 抽象 符合 作为 信息 传递 的 介质 ,使 人 类 可 以 理解 这 些 信 息 所 包含 
的 意义 或 指 代 的 实体 。 

算盘 是 由 柱子 和 珠子 组 成 的 最 早 的 人 机 交互 界面 。 在 计算 机 出 现 的 早期 , 批 处 理 界 
面 (1945 一 1968 年 ) 和 命令 行 界面 (1969 一 1983 年 ) 得 到 广泛 的 使 用 。 目 前 ,流行 的 用 户 
界面 是 图 形 用 户 界 面 (Graphical User Interface. GUD ,采用 图 像 的 方式 与 用 户 进行 交 
互 。 与 早期 的 交互 界面 相 比 , 图 形 界 面 对 于 用 户 来 说 更 加 简便 易 用 ,用 户 从 此 不 再 需要 
记 住 大 量 的 命令 ,取而代之 的 是 通过 窗口 .菜单 和 按钮 等 方式 来 进行 操作 。 未 来 的 用 户 
界面 将 更 多 地 运用 虚拟 现实 技术 ,使 用 户 能 够 摆脱 键盘 与 鼠标 的 交互 方式 ,而 通过 动作 、 
语言 ,甚至 是 脑 电 波 来 控制 计算 机 。 当 然 , 对 用 户 界面 的 深入 探讨 远 超 出 了 本 书 的 涉及 
范围 , 感 兴趣 的 读者 可 以 阅读 相关 书籍 。 

在 手机 上 进行 用 户 界 面 设计 是 一 项 具体 挑战 性 的 工作 。 首 先 , 手 机 的 界面 设计 者 和 
程序 开发 者 是 独立 且 并 行 工 作 的 ,这 就 需要 界面 设计 与 程序 逻辑 完全 分 离 , 不 仅 有 利于 
并 行 工 作 ,而 且 在 后 期 修改 界面 时 也 可 以 避免 修改 程序 的 逻辑 代码 ;其 次 ,不 同型 号 手机 
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的 屏幕 解析 度 `. 尺寸 和 长 宽 比 各 不 相同 ,程序 界面 需要 能 够 根据 屏幕 信息 ,自动 调整 界面 
控件 的 位 置 和 尺寸 ,避免 因为 屏幕 解析 度 . 尺 寸 或 纵横 比 的 变化 而 出 现 显示 错误 ;最 后 ， 
手机 屏幕 尺寸 较 小 ,设计 者 必须 能 够 合理 利用 有 限 的 显示 空间 ,构造 出 符合 人 机 交互 规 
则 的 用 户 界面 ,避免 出 现 凌 乱 、 拥 挤 的 用 户 界面 。 

Android 系统 已 经 为 使 用 者 解决 了 界面 设计 前 两 个 问题 。 在 界面 设计 与 程序 多 辑 分 
离 方面 ,Android 程序 将 用 户 界 面 和 资源 从 逻辑 代码 中 分 离 出 来 ,使 用 XML 文件 对 用 户 
界面 进行 描述 ,资源 文件 独立 保存 在 资源 文件 夹 中 。Android 系统 的 用 户 界 面 描述 非常 
灵活 ,允许 模糊 定义 界面 元 素 的 位 置 和 尺寸 ,通过 声明 界面 元 素 的 相对 位 置 和 粗略 尺寸 ， 
从 而 使 界面 元 素 能 够 根据 屏幕 尺寸 和 屏幕 摆 放 方式 动态 调整 显示 方式 。 

Android 用 户 界 面 框架 (Android UI Framework) 采 用 MVC( Model-View-Controller) fi 
型 ,为 用 户 界面 提供 了 处 理 用 户 输入 的 控制 器 (Controller) 和 显示 图 像 的 视图 (View) , 模 
型 (Model) 是 应 用 程序 的 核心 ,数据 和 代码 被 保存 在 模型 中 。 控 制 器 .视图 和 模型 的 关系 
如 图 5. 1 所 示 。 

MVC 模型 中 的 视图 将 应 用 程序 的 信息 反馈 给 用 户 , 可 能 的 反馈 方法 包括 视觉 .听觉 
或 触觉 等 ,但 最 常用 的 就 是 通过 屏幕 显示 反馈 信息 。Android 系统 的 界面 元 素 以 一 种 树 
型 结构 组 织 在 一 起 ,这 种 树 型 结构 称 为 视图 树 (View Tree) ,如 图 5. 2 所 示 。Android £ 
统 在 屏幕 上 绘制 界面 元 素 时 ,会 依据 视图 树 的 结构 从 上 至 下 绘制 每 一 个 界面 元 素 。 每 个 
元 素 负责 对 自身 的 绘制 ,如 果 元 素 包 含 子 元 素 ,该 元 素 会 通知 其 下 所 有 子 元 素 进行 绘制 。 
Android 系统 在 用 户 界面 绘制 上 还 有 一 些 提高 效率 的 办 法 ,例如 ,如 果 父 元 素 能 够 确定 某 
个 区 域 一 定 会 被 其 子 元 素 绘制 , 则 父 元 素 会 停止 绘制 该 区 域 ,以 提高 屏幕 绘制 的 效率 , 缩 
短 绘制 时 间 。 


键盘 等 输入 


ViewGroup 


View ViewGroup View 


绘制 界面 


| View View View 


5.1 MVC 模型 图 5.2 视图 树 


视图 树 由 View 和 ViewGroup 构成 。View 是 界面 中 最 基本 的 可 视 单 元 ,存储 了 屏 
幕 上 特定 矩形 区 域内 所 显示 内 容 的 数据 结构 ,并 能 够 实现 所 占据 区 域 的 界面 绘制 、 焦 点 
变化 .用 户 输入 和 界面 事件 处 理 等 功能 。View 也 是 一 个 重要 的 基 类 ,所 有 在 界面 上 的 可 
见 元 素 都 是 View 的 子 类 。ViewGroup 是 一 种 能 够 承载 多 个 View 的 显示 单元 ,一 般 有 
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两 个 用 途 ,一 个 是 承载 界面 布局 , 另 一 个 是 承载 具有 原子 特性 的 重 构 模块 。 

MVC 模型 中 的 控制 器 能 够 接收 并 响应 程序 的 外 部 动作 ,如 按键 动作 或 触摸 屏幕 动 
作 等 。 控 制 器 使 用 队列 处 理 外 部 动作 ,每 个 外 部 动作 作为 一 个 独立 的 事件 被 加 入 队列 
中 ,然后 Android 用 户 界 面 框架 按照 "先进 先 出 ”的 规则 从 队列 中 获取 事件 ,并 将 这 个 事 
件 分 配给 所 对 应 的 事件 处 理 函 数 。 

Android 用 户 界面 框架 中 另 一 个 重要 的 概念 就 是 单线 程 用 户 界面 (Single-threaded 
UI)。 在 单线 程 用 户 界面 中 ,控制 器 从 队列 中 获取 事件 ,视图 在 屏幕 上 绘制 用 户 界面 ,使 
用 的 都 是 同一 个 线程 。 单 线程 用 户 界 面 能 够 降低 应 用 程序 的 复杂 程度 ,同时 也 能 降低 开 
发 的 难度 。 首 先 ,用 户 不 需要 在 控制 器 和 视图 之 间 进 行 同步 。 其 次 ,所 有 事件 处 理 完全 
按照 其 加 入 队列 的 顺序 进行 ,也 就 是 说 ,在 事件 处 理 函 数 返 回 前 不 会 处 理 其 他 事件 ,因此 
用 户 界 面 的 事件 处 理 函数 具有 原子 性 。 但 单线 程 用 户 界 面 也 有 其 缺点 ,如 果 事 件 处 理 函 
数 过 于 复杂 ,可 能 会 导致 用 户 界面 失去 响应 。 因 此 尽 可 能 在 事件 处 理 函数 中 使 用 简短 的 
代码 ,或 将 复杂 的 工作 交 给 后 台 线 程 处 理 。 


52 界面 控件 


Android 系统 的 界面 控件 分 为 定制 控件 和 系统 控件 。 定 制 控件 是 用 户 独立 开发 的 控 
件 ,或 通过 继承 并 修改 系统 控件 后 所 产生 的 新 控件 ,能 够 提供 特殊 的 功能 和 显示 需求 。 
系统 控件 是 Android 系统 中 已 经 封装 的 界面 控件 ,是 应 用 程序 开发 过 程 中 最 常见 的 功能 
控件 。 系 统 控 件 更 有 利于 进行 快速 开发 ,同时 能 够 使 Android 应 用 程序 的 界面 保持 一 定 
的 一 致 性 。 

常见 的 系统 控件 包括 TextView、EditText、 Button, ImageButton, Checkbox, 
RadioButton,Spinner, ListView 和 TabHost, 
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TextView 是 一 种 用 于 显示 字符 的 控件 ,EditText 则 是 用 来 输入 和 编辑 字符 的 控件 ， 
因为 EditText 继承 于 TextView, 所 以 Edit Text 是 一 个 具有 编辑 功能 的 Text View 控件 。 

TextViewDemo 示例 如 图 5. 3 所 示 , 从 上 至 下 分 别 是 TextView01 和 Edit Text01, 
在 XML 文件 中 (/res/layout/main. xml) 中 的 代码 如 下 。 


<TextView апагоіа:іа= "ё +id/TextView01" 
android:layout width= "wrap content" 


android:layout height- "wrap content" 


android:text- "TextViewO1l" > 

< /TextView» 

«EditText android:id- "ё + id/EditTextOl" 
android:layout width- "fill parent" 


android:layout height- "wrap content" 


о 0 ы O O > шю P 


android:text- "EditTextOl" > 
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10 «/EditText» 


TextViewDemo 


Rajan 


图 5.3 TextView 和 EditText 


第 1 行 android:id 属性 声明 了 TextView 的 ID, 这 个 ID 主要 用 于 在 代码 中 引用 
TextView 对 象 。@ 十 id/TextView01 表示 所 设置 的 ID 值 ,其 中 四 表示 后 面 的 字符 串 是 
ID 资源 ;加 号 (十 ) 表 示 需 要 建立 新 资源 名 称 , 并 添加 到 К. java 文件 中 ;和 斜 杠 后 面 的 字符 
串 (TextView01) 表 示 新 资源 的 名 称 。 如 果 不 是 新 添加 的 资源 ,或 属于 Android 框架 的 资 
源 , 则 不 需要 使 用 加 号 ,但 必须 添加 Android 包 的 命名 空间 ,例如 android: id =" @ 
android ;id/empty" , 


第 2 行 的 android:layout width 属性 用 来 设置 TextView 的 宽度 , wrap, content X 


示 TextView 的 宽度 只 要 能 够 包含 所 显示 的 字符 串 即 可 。 第 2 fT IJ android: layout | 


height 属性 用 来 设置 Text View 的 高 度 。 第 4 行 表示 TextView 所 显示 的 字符 串 ,在 后 面 
将 通过 代码 更 改 TextView 的 显示 内 容 。 第 7 行 中 fill_content 表示 EditText 的 宽度 将 
等 于 父 控件 的 宽度 。 

TextViewDemo. java 文件 中 ,引用 XML 文件 中 建立 的 TextView 和 EditText, 并 更 
改 其 显示 内 容 。 为 了 能 够 使 程序 正常 运行 ,需要 在 代码 中 引入 android. widget. Edit Text 
和 android. widget. TextView。 

TextView textView- (TextView)findViewById(R.id.TextView01); 


EditText editText- (EditText) findViewById (R.id.EditTextO01); 


textView.setText ("H P! Ж :"); 


ьш b оҥ 


editText.setText ("Rajan") ; 


第 1 行 的 findViewById() 函 数 能 够 通过 ID 引用 界面 上 的 任何 控件 ,只 要 该 控件 在 
XML 文件 中 定义 过 ID 即 可 。 第 3 行 的 setText() 函 数 用 来 设置 TextView 所 显示 的 
内 容 。 


522 Button 和 ImageButton 


Button 是 按钮 控件 ,用 户 能 够 在 该 控件 上 点 击 , 引 发 相应 的 事件 处 理 函 数 。 如 果 需 
要 在 按钮 上 显示 图 像 ,可 以 使 用 Android 系统 提供 的 ImageButton 控件 ,图 5.4 是 
ButtonDemo 示例 ,上 方 是 Button 控件 ,下 方 是 ImageButton 控件 。 

ButtonDemo 示例 从 上 至 下 分 别 是 TextView01、Button01 和 ImageButton01, fE 
XML 文件 中 (/res/layout/main. xml) 中 的 代码 如 下 。 
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ButtonDemo 


BUTTON 按 钮 


s 


F: G 8:00 


Æ 5.4 Button 和 ImageButton 


E « Button android:id- "ё + id/Button01" 

2 android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:text- "Button01l" > 


« /Button» 


android:layout width- "wrap content" 
android:layout height- "wrap content" 


« /ImageButton» 


XML 文件 中 定义 了 两 个 按钮 的 宽度 和 高 
总, 并 定义 了 Button 控件 所 显示 的 内 容 , 但 没有 
定义 ImageButton 所 显示 的 图 像 ,显示 图 像 内 容 
在 后 面 的 代码 中 进行 定义 。 

Android 系统 支持 多 种 图 形 格式 ,如 png ico 
等 ,本 例 ImageButton 所 使 用 的 是 png 格式 。 首 
先 在 /res 目录 下 建立 drawable 目录 ,然后 将 
download. png 文件 复制 到 /res/drawable 文件 夹 
下 ,在 /res 目录 上 选择 Refresh( 如 图 5.5 所 示 )， 
刷新 后 新 添加 的 文件 将 显示 在 /res/drawable 文 
件 夹 下 ,同时 R. java 文件 内 容 也 得 到 了 更 新 。 如 
Ж К. java 文件 不 更 新 则 无 法 在 代码 中 使 用 该 资 
源 , 会 出 现 无 法 找到 资源 的 错误 提示 。 

ButtonDemo. java 文件 中 ,引用 XML 文件 
建立 的 Button 和 ImageButton ,更 改 Button 显示 
字符 内 容 和 ImageButton 图 像 内容 。 为 了 程序 正 
常 运行 ,需要 在 代码 中 引入 android. widget 


.Button 和 android. widget. ImageButton 。 


3 
4 
5 
6  «ImageButton android:id- "@ + id/ImageButton01" 
1 
8 
9 


New 


Go Into 


Open in New Window 


Show In AltShi Et 
B Сору Ctrl+C 
Ва Сору Qualified Name 
Фрее Ctrlty 
其 Delete Delete 
Build Path 
Refactor AlttShift*+T 
is Import. 
ШЛ Export. 
Pg FS 


Assign Working Sets. 


Validate 

Bun As 

Debug As 

Team 

Compare With 

Restore from Local History. 


Source 


Properties AltEnter 


图 5.5 更 新 文件 


工 Button button= (Button) findViewById(R.id.Button01); 


2 ImageButton imageButton= (ImageButton) ҒіпауіемВута (R.id.ImageButton01); 
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3  button.setText ("Button 按钮 ") ; 
4 imageButton.setImageResource (R.drawable.download); 


第 1 行 和 第 2 行 代码 用 于 引用 在 XML 文件 中 定义 的 Button 控件 和 ImageButton 
控件 。 第 3 行 代码 将 Button 的 显示 内 容 更 改 为 “Button f Hl". 58 4 行 代码 利用 
setImageResource C ) 函数 ,将 新 加 入 的 png 文件 К. drawable. download 传递 给 
ImageButton 。 

为 了 能 够 使 按钮 响应 点 击 事件 ,在 onCreateO PR +1 Button 控件 和 ImageButton 
控件 添加 点 击 事件 的 监听 器 ,代码 如 下 。 


final TextView textView- (TextView)findViewById(R.id.TextView01); 
button.setOnClickListener (new View.OnClickListener () { 
public void onClick (View view)( 


textView.setText ("Button 按钮 "); 


n; 

imageButton.setOnClickListener (new View.OnClickListener () ( 
public void onClick (View view) { 

textView.setText ("ImageButton 按钮 "); 


£ 
3 
4 
5 } 
6 
T 
8 
9 

在 第 2 行 代码 中 ,button 对 象 通过 调用 setOnClickListener O 函数 ,注册 一 个 点 击 
(CClick) 事 件 的 监听 器 View. OnClickListener()。 第 3 行 代码 是 点 击 事件 的 回调 函数 。 
第 4 行 代码 将 TextView 的 显示 内 容 更 改 为 "Button 按钮 ”。 

View. OnClickListener() 是 View 定义 的 点 击 事件 的 监听 器 接口 ,并 在 接口 中 仅 定 
XT onClickO Ж. `4 Button 从 Android 界面 框架 中 接收 到 事件 后 ,首先 检查 这 个 事 
件 是 否 是 点 击 事件 ,如 果 是 点 击 事件 ,同时 Button 又 注册 了 监听 器 , 则 会 调用 该 监听 器 中 
的 onClick O 函数 。 

每 个 View 仅 可 以 注册 一 个 点 击 事件 的 监听 器 ,如 果 使 用 setOnClickListener O 函数 
注册 第 二 个 点 击 事件 的 监听 器 ,之 前 注册 的 监听 器 将 被 自动 注销 。 给 每 个 按钮 注册 一 个 
点 击 事件 监听 器 ,每 个 按钮 的 事件 处 理 程 序 都 有 各 自 的 onClick() 函 数 ,这 样 能 够 使 代码 
更 加 清晰 、 易 读 , 且 易 于 维护 。 当 然 , 也 可 以 将 多 个 按钮 注册 到 同一 个 点 击 事件 的 监听 器 
上 ,示例 代码 如 下 。 


X Button.OnClickListener buttonListener- new Button.OnClickListener () { 
2 @Оуеггіае 

3 public void onClick (View у) { 

4 switch (у.деёта ()) { 

5 case R.id.Button01: 

6 textView.setText ("Button 按钮 "); 

T return; 


8 case R.id.ImageButton01: 
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9 textView.setText ("ImageButton 按钮 ") ; 
10 return; 

11 } 

12 )); 

13 button.setOnClickListener (buttonListener); 

14 imageButton.setOnClickListener (buttonListener); 


第 1 行 至 第 12 行 代码 定义 了 一 个 名 为 buttonListener 的 点 击 事件 监听 器 ,第 13 行 
和 第 14 行 代 码 分 别 将 给 该 监听 器 注册 到 Button 和 ImageButton E. 


523 CheckBox 和 RadioButton 


CheckBox 是 同时 可 以 选择 多 个 选项 的 控件 ,而 RadioButton 则 是 仅 可 以 选择 一 个 选 
项 的 控件 。RadioGroup Æ RadioButton 的 承载 体 ,程序 运行 时 不 可 见 , 应 用 程序 中 可 能 
包含 一 个 或 多 个 RadioGroup。RadioGroup 包含 多 个 RadioButton ,在 一 个 RadioGroup 
中 ,用 户 仅 能 够 选择 其 中 的 一 个 RadioButton。 在 图 5.6 中 ,RadioGroup 中 包含 两 个 
RadioButton , 当选 择 RadioButtonl 后 ,RadioButton2 自动 变 为 非 选 择 状态 。 


CheckboxRadiobuttonDemo 


C checkBoxo1 


CheckBox02 
© RadioButton01 


RadioButton02 


5.6 CheckBox 和 RadioButton 


CheckboxRadiobuttonDemo 示例 如 图 5. 6 Ак. 从 上 至 下 分 别 是 TextView01、 
CheckBox01、CheckBox02、RadioButton01 和 RadioButton02。 在 XML 文件 中 (/res/ 
layout/main. xml) 中 的 代码 如 下 。 

1 < TextView android:id- "@ + id/TextView01" 


2 android:layout width- "fill parent" 
android:layout height- "wrap content" 


android:text- "@ string/hello"/» 
< CheckBox android:id- "6 + id/CheckBox01" 


3 
4 
5 
6 android:layout width- "wrap content" 
7 android:layout height- "wrap content" 
8 android:text- "СһескВох01" > 

9 < /CheckBox> 

10 <CheckBox android:id- "@+id/CheckBox02" 
11 android:layout width- "wrap content" 


A2. android:layout height- "wrap content" 
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android:text- "CheckBox0?" > 
< /СһескВох> 
«RadioGroup android:id- "ё + id/RadioGroupOl" 
android:layout width- "wrap content" 
android:layout height- "wrap content"? 
< RadioButton android:id- "ё + id/RadioButtonOl" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:text- "RadioButtonOl" > 
« /RadioButton» 
< RadioButton android:id- "ё + id/RadioButton02" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:text- "RadioButton02" » 
« /RadioButton» 
« /RadioGroup» 


第 15 行 二 RadioGroup 二 标签 声明 了 一 个 RadioGroup. TE 25 18 行 和 第 23 行 分 别 声 
明了 两 个 RadioButton ,这 两 个 RadioButton 是 RadioGroup 的 子 元 素 。 
在 代码 中 引用 CheckBox 和 RadioButton 的 方法 可 以 参考 下 面 的 代码 。 


1 


5 
2 


CheckBox checkBox1= (CheckBox) ҒіпауіемВута (к.іа.СһескВох01); 
RadioButton radioButtonl- (RadioButton) findViewById (R.id.RadioButton01); 


CheckBox 设置 点 击 事件 监听 器 的 方法 ,与 Button 中 介绍 的 方法 相似 ,唯一 不 同 在 


чо 0c > ш 


于 将 Button. OnClickListener 换 成 了 CheckBox. OnClickListener, 下 面 给 出 简要 代码 。 


CheckBox.OnClickListener checkboxListener=new CheckBox.OnClickListener () ( 
@ Override 
public void onClick (View у) { 
// 过 程 代码 
He 
checkBoxl.setOnClickListener (checkboxListener); 
checkBox2.setOnClickListener (checkboxListener); 


RadioButton 设置 点 击 事件 监听 器 的 方法 。 


M всу m > ш 


RadioButton.OnClickListener radioButtonListener- new RadioButton 
.OnClickListener () { 

@override 

public void onClick (View у) { 

// 过 程 代码 

н; 
radioButtonl.setOnClickListener (radioButtonListener); 
radioButton2.setOnClickListener (radioButtonListener); 
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Spinner 


Spinner 是 从 多 个 选项 中 选择 一 个 选项 的 控件 ,类 似 于 桌面 程序 的 组 合 框 
(ComboBox) ,但 没有 组 合 框 的 下 拉 菜 单 ,而 是 使 用 浮动 菜单 为 用 户 提供 选择 。 

SpinnerDemo 示例 如 图 5. 7 所 示 , 从 上 至 下 分 别 是 TextView01 和 Spinner01。 在 
XML 文件 中 (/res/layout/main. xml) 中 的 代码 如 下 。 


1 


N 


第 


<TextView android:id="@ +id/TextView01" 
android:layout width- "fill parent" 


android:layout height- "wrap content" 


android:text- "@ string/hello"/» 
«Spinner android:id- "Q + id/Spinner01" 

android:layout width- "300dip" 

android:layout height- "wrap content" 


« /Spinner» 


SpinnerDemo 


Spinner 子 项 1 


Spinner 子 项 2 


Spinner 子 项 3 


5.7 Spinner 


5 行使 用 二 Spinner 二 标签 声明 了 一 个 Spinner 控件 ,并 在 第 6 行 代码 中 指定 该 控 


件 的 宽度 为 300dip。 


在 
添加 在 


SpinnerDemo. java 文件 中 ,定义 一 个 ArrayAdapter 适配器 ,在 ArrayAdapter 中 
Spinner 中 可 以 选择 的 内 容 。 为 了 使 程序 能 够 正常 运行 ,需要 在 代码 中 引入 


android. widget. ArrayAdapter 和 android. widget. Spinner。 


€ 


№ 


有 
Б 


vr 


Spinner spinner- (Spinner) findViewById (R.id.Spinner01); e aeri 
List« String» list = пем ArrayList« String» (); 
list .add ("Spinner F 1"); 

list .add("Spinner F 2"); 

list .add("Spinner F 3"); 

ArrayAdapter« String» adapter- new ArrayAdapter« String» (this, android. R. layout. 
simple spinner item, list); 

adapter.setDropDownViewResource (android.R.layout.simple spinner dropdown item); 
Spinner.setAdapter (adapter); 


2 行 代 码 建立 了 一 个 字符 串 数 组 列表 (ArrayList) ,这 种 数组 列表 可 以 根据 需要 进 


行 增 减 ,二 String 之 表示 数组 列表 中 保存 的 是 字符 串 类 型 的 数据 。 在 代码 的 第 3.4.5 fT 
中 ,使 用 add() 函 数 分 别 向 数组 列表 中 添加 三 个 字符 串 。 第 6 行 代 码 建立 了 一 个 
Array Adapter 的 数组 适配器 ,数组 适配器 能 够 将 界面 控件 和 底层 数据 绑 定 在 一 起 。 在 这 
里 ArrayAdapter 将 Spinner 和 ArrayList 绑 定 在 一 起 ,所 有 ArrayList 中 的 数据 将 显示 
TE Spinner 的 浮动 菜单 中 , 绑 定 过 程 由 第 8 行 代码 实现 。 第 7 行 代码 设 定 了 Spinner 浮动 
菜单 的 显示 方式 ,其 中 ,android. К. layout. simple spinner. dropdown item 是 Android £ 
统 内 置 的 一 种 浮动 菜单 ,如 图 5.7 所 示 。 如 果 将 其 改 为 android. R. layout. simple _ 
spinner_item, 则 显示 效果 如 图 5. 8 所 示 。 


SpinnerDemo 


Spinner 子 项 1 
Spinner 子 项 2 
Spinner 子 项 3 


5.8 Spinner 的 item 菜单 


为 了 保证 用 户 界面 显示 的 内 容 与 底层 数据 一 臻 ,应 用 程序 需要 监视 底层 数据 的 变 
化 ,如 果 底 层 数据 更 改 了 , 则 用 户 界面 也 需要 修改 显示 内 容 。 在 使 用 适配器 绑 定 界面 控 
件 和 底层 数据 后 ,应 用 程序 就 不 需要 再 监视 底层 数据 的 变化 ,从 而 极 大 地 简化 了 代码 的 
复杂 性 。 


525 ListView 


ListView 是 用 于 垂直 显示 的 列表 控件 ,如 果 显 示 内 容 过 多 , 则 会 出 现 垂直 滚动 条 。 
ListView 是 在 界面 设计 中 经 常 使 用 的 界面 控件 ,其 原因 是 List View 能 够 通过 适配器 将 
数据 和 显示 控件 绑 定 , 在 有 限 的 屏幕 上 提供 大 量 内 容 供用 户 选择 ;而 且 支 持 点 击 事件 ,可 
以 用 少量 的 代码 实现 复杂 的 选择 功能 。 

ListViewDemo 示例 如 图 5. 9 所 示 , 从 上 至 下 分 别 是 TextView01 和 ListView01 。 
在 XML 文件 中 (/res/layout/main. xml) 中 的 核心 代码 如 下 。 


«TextView android:id="@ + id/TextView01" 
android:layout width="fill parent" 
android:layout height="wrap content" 
android:text- "Q@ string/hello" /> 

«ListView android:id- "ё + id/ListViewOl" 
android:layout width- "wrap content" 


android:layout height- "wrap content"» 


очо 0 í шю P 


< /ListView» 


在 ListViewDemo. java 文件 中 ,首先 需要 为 ListView 创建 适配器 ,并 添加 ListView 


96 


baroia fz A 41 2 3 Z (7 3) 


ListViewDemo 


ListView 子 项 1 


ListView 子 项 2 


ListView 子 项 3 


5.9 ListView 


中 所 显示 的 内 容 。 


чо 0 ^ ш 


8 
数组 列 
数组 列 

下 
选择 的 


N 


a 


RI 
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final TextView textView= (TextView)findViewById(R.id.TextView01); 
ListView listView= (ListView)findViewById(R.id.ListView01); 
List<String>list =new ArrayList« String» (); 

list.add ("ListView F 1"); 


2"); 


list.add ("ListView Fi 


list.add ("ListView ЁЙ 3"); 

ArrayAdapter< String> adapter=new ArrayAdapter< String> (this,android.R 
.layout.simple list_item 1, list); 

listView.setAdapter (adapter); 


2 行 代码 通过 ID 引用 了 XML 文件 中 声明 的 ListView, 583 行 至 第 6 行 声 明了 
表 。 第 7 行 声明 了 适配器 ArrayAdapter. 98 3 个 参数 list 说 明 适 配器 的 数据 源 为 
表 。 第 8 行将 ListView 和 适配器 绑 定 。 

面 的 代码 声明 了 ListView 子 项 的 点 击 事件 监听 器 ,用 以 判断 用 户 在 ListView 中 


是 哪 一 个 子 项 。 


AdapterView.OnlItemClickListener listViewListener- new 
AdapterView.OnItemClickListener () { 
@override 


public void onItemClick (AdapterView< ?>arg0, View argl, int 
arg2, long arg3) { 
String msg- "4 View:"+ arg0.toString()- "\п"+ f. View:"targl .toString()* "V 
n"+ "位 置 :"+ String.valueOf (arg2) + ", ID: "+ String .valueOf (arg3) ; 
textView.setText (msg) ; 
H 
listView.setOnItemClickListener (listViewListener); 


1 fT AdapterView. OnItemClickListener 是 ListView 子 项 的 点 击 


[lp] 


F (T EUIS. 
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同样 是 一 个 接口 .需要 实现 onltemClick (O K Zt. fE ListView 子 项 被 选择 后 ， 
onItemClick() 函 数 将 被 调用 。 第 3 行 的 onItemClick() 函数 中 一 共有 4 个 参数 : 参数 1 
表示 适配器 控件 ,这 里 就 是 ListView; 参 数 2 表示 适配器 内 部 的 控件 ,这 里 是 ListView 
中 的 子 项 ;参数 3 表示 适配器 内 部 的 控件 ,也 就 是 子 项 的 位 置 ;参数 4 表示 子 项 的 行 号 。 
第 4 行 和 第 5 行 代码 用 于 显示 信息 ,选择 子 项 确定 后 ,在 TextView 中 显示 子 项 父 控件 的 
信息 、 子 控件 信息 、 位 置信 息 和 ID 信息。 第 7 行 代码 是 ListView 指定 刚 声 明 的 监听 器 。 


526 TabHost 


Tab 标签 页 是 界面 设计 中 经 常 使 用 的 界面 控件 ,可 以 实现 多 个 分 页 之 间 的 切换 ,每 
个 标签 页 可 以 显示 不 同 内 容 。 如 图 5. 10 Android 系统 内 置 的 “拨号 界面 ", 通 过 标签 
页 在 拨号 .查看 记录 和 联系 人 功能 之 间 直 接 切 换 。 


АД ü 8:11 


а 输入 姓名 或 手机 号 : 


快速 拨号 


5.10 TabHost 


在 Android SDK 3.0 中 , 随 着 新 的 UT 设计 思想 的 引入 android. app. Fragment 成 为 
一 种 新 的 界面 设计 模式 。Android SDK 4.0 继承 了 3.0 版 本 的 设计 思路 ,因此 不 建议 开 
发 者 使 用 android. app. TabActivity ,而 应 使 用 新 出 现 的 Fragment 实现 Tab 标签 页 。 但 
因 旧 版 本 Android 系统 还 有 一 定 的 生存 周期 , 且 使 用 TabActivity 实现 的 Tab 标签 页 的 
方法 在 Android SDK 5. 0 中 仍 可 以 正常 运行 ,所 以 本 书 仍 对 这 种 方法 进行 介绍 。 

这 里 以 TabDemo 为 例 , 说 明 如 何 设计 和 使 用 TabHost。TabDemo 示例 的 运行 结果 
如 图 5. 11 所 示 。 

Tab 标签 页 的 使 用 首先 要 设计 所 有 分 页 的 界面 布局 。 在 分 页 设计 完成 后 ,使 用 代码 
建立 Tab 标签 页 ,并 给 每 个 分 页 添加 标识 和 标题 。 最 后 确定 每 个 分 页 所 显示 的 界面 
布局 。 

在 设计 分 页 的 界面 布局 时 ,使 用 的 方法 与 设计 普通 用 户 界面 没有 什么 区 别 。 为 了 便 
于 可 视 化 和 编码 ,为 每 个 分 页 建立 一 个 XML 文件 ,用 以 编辑 和 保存 分 页 的 界面 布局 。 在 
TabDemo 示例 中 ,在 /res/layout 文件 夹 中 建立 三 个 XML 文件 ,分 别 为 tabl. xml, tab2 


98 а hdroid /z A 41 2 # Z (7 ЗА) 


TabDemo 
TabDemo 


线性 布局 


图 5.11 TabDemo 示例 的 运行 结果 


.xml 和 tab3. xml, 这 三 个 文件 分 别 使 用 线性 布局 .相对 布局 和 绝对 布局 实例 中 的 main 
.xml 的 代码 ,并 将 布局 的 ID 分 别 定 义 为 layout01、layout02 和 layout03。 下 面 分 别 给 出 
tabl. xml tab2. xml 和 tab3. xml 文件 的 部 分 代码 。 

tabl. xml 文件 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"? > 
2 < LinearLayout android:id- "ё + id/layout01" 


3 
4 ..... 
5 


< /LinearLayout» 
tab2. xml 文件 代码 如 下 。 


$ «?xml version= "1.0" encoding- "utf- 8"?» 


2 < AbsoluteLayout android:id- "ё + id/layout02" 


3 
4 == 
5 


< /AbsoluteLayout» 
tab3. xml 文件 代码 如 下 。 


Ж. «?xml version- "1.0" encoding- "utf- 8"? > 


2 «RelativeLayout android:id- "6 + id/layout03" 
F. o xe 
4 
5  «/RelativeLayout» 

分 页 的 布局 代码 设计 完成 后 ,在 TabDemoActivity. java 文件 中 键入 下 面 的 代码 , 创 
建 Tab 标签 页 ,并 建立 子 页 与 界面 布局 直接 的 关联 关系 。 


1 package edu.hrbeu.TabDemo; 


N 


3 import android.app.TabActivity; 
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4 import android.os.Bundle; 

5 import android.widget.TabHost; 

6 import android.view.LayoutInflater; 

E @ SuppressWarnings ("deprecation") 

8 public class TabDemoActivity extends TabActivity ( 

9 @Override 

10 public void onCreate (Bundle savedInstanceState) { 

u super.onCreate (savedInstanceState); 

12 TabHost tabHost- getTabHost () 7 

13 LayoutInflater.from(this).inflate(R.layout.tabl, tabHost 
-getTabContentView () , true) ; 

14 LayoutInflater.from(this).inflate (R.layout.tab2, tabHost 
-getTabContentView () , true); 

15 LayoutInflater.from(this).inflate (R.layout.tab3, tabHost 
-getTabContentView () , true) ; 

16 tabHost.addTab (tabHost .newTabSpec ("TAB1") 

17 .setIndicator (" 线 性 布局 ") .setContent (R. id.layout01)); 

18 tabHost.addTab (tabHost . newTabSpec ("TAB2") 

19 .setIndicator ("绝对 布局 ") .setContent (R.id.layout02)); 

20 tabHost.addTab (tabHost .newTabSpec ("TAB3") 

21 .setIndicator ("相对 布局 ") .setContent (R.id.layout03)); 

22 } 

23 } 


第 7 行 代码 是 避免 编译 器 出 现 警 告 信息 。 因 为 TabActivity 已 经 过 期 ,强制 使 用 会 
出 现 大 量 的 警告 信息 ,这 里 使 用 @SuppressWarnings("deprecation") 可 以 将 因 API 过 期 
所 产生 的 警告 信息 屏蔽 。 

第 8 行 代 码 的 声明 TabDemoActivity 类 继承 于 TabActivity, 与 以 往 继承 Activity 不 
同 ,TabActivity XIF NIZA Activity 或 View。 第 12 行 代 码 通过 getTabHost ) PR Zt 
获得 了 Tab 标签 页 的 容器 ,用 以 承载 可 以 点 击 的 Tab 标签 和 分 页 的 界面 布局 。 第 13 行 
代码 通过 LayoutInflater 将 tabl. xml 文件 中 的 布局 转换 为 Tab 标签 页 可 以 使 用 的 View 
对 象 。 第 16 行 代码 使 用 add Tab O 函数 添 加 了 第 1 个 分 页 , tabHost. newTabSpec 
("TAB1") 表 明 在 第 12 行 代码 中 建立 的 tabHost 上 ,添加 一 个 标识 为 TABI 的 Tab 分 
页 。 第 17 行 代码 使 用 setIndicator() 函 数 设 定 分 页 显示 的 标题 ,使 用 setContent O PR Zt 
设 定 分 页 所 关联 的 界面 布局 。 

在 实现 Tab 标签 页 时 ,除了 可 以 将 多 个 Tab 分 页 放置 在 同一 个 Activity 中 ,还 可 以 
将 不 同 Tab 分 页 加 载 到 不 同 的 Activity 上 。 两 种 方式 在 界面 显示 上 是 没有 区 别 的 ,但 笔 
者 建议 使 用 后 一 种 方式 处 理 Tab 分 页 和 Activity 之 间 的 关系 ,每 个 Tab 分 页 对 应 一 个 
Activity, 有 利于 用 户 对 界面 控件 的 管理 和 控制 。 

TabDemo2 示例 说 明 如 何 将 不 同 的 Activity 显示 在 不 同 的 Tab 分 页 上 。TabDemo2 
示例 与 TabDemo 示例 的 用 户 界面 是 完全 相同 的 ,所 以 界面 可 以 参考 图 5. 11。 

从 图 5. 12 可 以 发 现 ,与 TabDemol 示例 相 比 ,TabDemo2 示例 的 布局 文件 夹 中 
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C/res/layout) 'P Z T — + main. xml 文件 ,代码 文件 夹 中 增加 了 TablActivity. java, 
Tab2Activity. java 和 Tab3Activity. java 三 个 文件 。 


B src 
88 edu.hrbeu.TabDemo2 
国 TablActivityjava 
国 Tab2Activityjava 
国 Tab3Activityjava 
D TabDemo2Activityjava 
Ë gen [Generated Java Files] 
mÀ Android 40 
@ assets 
@ bin 
@ гез 
© drawable-hdpi 
© drawable-ldpi 
© drawable-mdpi 
© layout 
0 mainxml 
00 tablxml 
08 tab2.xml 
08 tab3.xml 
@ values 
В AndroidManifestxml 
[8 proguard.cfg 
project.properties 


5.12 TabDemo2 示例 文件 结构 


首先 给 出 TablActivity. java 文件 的 全 部 代码 : 


1 package edu.hrbeu.TabDemo2; 

2 

3 import android.app.Activity; 

4 import android.os.Bundle; 

5 

6 public class TablActivity extends Activity 

7 

8 @ Override 

9 public void onCreate (Bundle savedInstanceState)( 
10 super.onCreate (savedInstanceState); 
11 setContentView (R.layout.tabl); 

12 } 

13 于 


代码 第 11 行将 布局 目录 中 tabl. xml 文件 中 的 布局 加 载 到 TablActivity. 

Tabl Activity. java, Tab2Activity. java 和 Tab3Activity. java 的 作用 完全 相同 ,分别 
将 tabl. хт] tab2. xml 和 tab3. xml 加 载 到 三 个 不 同 的 Activity. 

下 面 分 析 TabDemo2Activity. java 文件 ,完整 代码 如 下 。 


1 package edu.hrbeu.TabDemo2; 

2 

3 import android.app.TabActivity; 

4 import android.content.Intent; 

5 import android.os.Bundle; 

6 import android.widget.TabHost; 

$ 

8 @ SuppressWarnings ("deprecation") 

9 public class TabDemo2Activity extends TabActivity { 

10 @ Override 

11 public void onCreate (Bundle savedInstanceState) { 

12 super.onCreate (savedInstanceState); 

13 setContentView (R.layout.main); 

14 

15 TabHost tabHost- getTabHost () ; 

16 

17 tabHost.addTab (tabHost. newTabSpec ( " ТАВ1"). setIndicator ("线性 布局 "). 
setContent (new Intent () .setClass (this, TablActivity.class))); 

18 tabHost.addTab (tabHost. newTabSpec ( " TAB2"). setIndicator ("绝对 布局 "). 
setContent (new Intent () .setClass (this, Tab2Activity.class))); 

19 tabHost.addTab (tabHost. newTabSpec (" TAB3"). setIndicator ("相对 布局 "). 
setContent (new Intent () .setClass (this, Tab3Activity.class))); 

20 } 

21 } 


代码 第 9 行 声 明 TabDemo2Activity 继承 TabActivity 2$, Е TabDemo 示例 中 , 代 
码 第 17 行 的 setContent O 函数 的 参数 是 布局 文件 ,而 TabDemo2 示例 的 setClass() 的 参 
数 是 Intent. 通过 Intent 启动 TablActivity。 这 里 就 是 两 个 示例 的 明显 不 同 之 处 ， 
TabDemo2 示例 为 每 个 Tab 分 页 指定 了 不 同 的 Activity。 第 13 行 代码 声明 了 
TabDemo2Activity 的 布局 文件 main. xml, 下 面 给 出 这 个 布局 文件 的 完整 代码 。 


<?xml version- "1.0" encoding- "utf- 8"?> 

< TabHost xmlns:android- "http: //schemas .android.com/apk/res/android" 
android:id- "ё android:id/tabhost" 
android:layout width- "fill parent" 
android:layout height- "fill parent"? 


«X LinearLayout 


android:orientation- "vertical" 


android:layout width- "fill parent" 


оф © ы O 0c > шю ҥе 


android:layout height="fill parent" 


H 
© 


android:padding= "5ар"> 


T 
ja 


< TabWidget 
апаго1а:14="@ android:id/tabs" 


H ы 
W N 


android:layout width="fill parent" 


m 
> 


android:layout height="wrap content" /> 
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15 < FrameLayout 
16 android:id- "6 android:id/tabcontent" 
17 android:layout width="fill parent" 
18 android:layout height="fill parent" 
19 android:padding= "3dp" /> 

20 < /LinearLayout> 


21 </TabHost> 


作为 TabActivity 的 布局 ,必须 以 TabHost 为 根 元 素 ( 代 码 第 2 行 ), 同 时 包含 
TabWidget 元 素 ( 代 码 第 1 行 ) 和 FrameLayout 元 素 ( 代 码 第 15 行 )。TabWidget 承载 
Tab 导航 栏 ,FrameLayout 承载 Tab 页 的 内 容 , 现 在 FrameLayout 是 空 的 ,在 程序 运行 
时 ,TabHost 会 自动 使 用 Activity 填充 FrameLayout。 因 为 TabWidget 和 FrameLayout 
需要 垂直 的 并 列 排 布 ,因此 使 用 线性 布局 (代码 第 6 行 )。 

最 后 ,在 AnroidManifest. xml 文件 中 添加 三 个 新 建 Activity 的 声明 : 


1 <activity android:name=".TablActivity" /> 
2 «activity android:name=".Tab2Activity" /> 
3 “activity android:name- ".Tab3Activity" /> 


53 界面 布局 


界面 布局 (Layout) 是 用 户 界面 结构 的 描述 ,定义 了 界面 中 所 有 的 元 素 、 结 构 和 相互 
关系 。 一 般 声明 Android 程序 的 界面 布局 有 两 种 方法 ,第 一 种 是 使 用 XML 文件 描述 界 
面 布局 , 另 一 种 是 在 程序 运行 时 动态 添加 或 修改 界面 布局 。 

Android 系统 在 声明 界面 布局 上 提供 了 很 好 的 灵活 性 ,用 户 既 可 以 独立 使 用 任何 一 
种 声明 界面 布局 的 方式 ,也 可 以 同时 使 用 两 种 方式 。 一 般 情况 下 ,使 用 XML 文件 来 描述 
用 户 界 面 中 的 基本 元 素 , 而 在 代码 中 动态 修改 需要 更 新 状态 的 界面 元 素 。 当 然 , 用 户 也 
可 以 将 所 有 的 界面 元 素 ,无 论 在 程序 运行 后 是 否 需 要 修改 其 内 容 ,都 放 在 代码 中 进行 定 
义 和 声 明 。 很 明显 这 不 是 一 种 良好 的 界面 设计 模式 ,会 给 后 期 界面 修改 带 来 不 必要 的 麻 
烦 , 而 且 界 面 元 素 较 多 时 ,程序 的 代码 也 会 显得 凌乱 不 堪 。 

使 用 XML 文件 声明 界面 布局 ,能 够 更 好 地 将 程序 的 表现 层 和 控制 层 分 离 , 在 修改 界 
面 时 将 不 再 需要 更 改 程序 的 源 代码 。 例 如 ,在 程序 开发 完成 后 ,为 了 让 程序 能 够 支持 不 
同 屏幕 尺寸 .规格 和 语言 的 手机 , 则 可 以 声明 多 个 XML 布局 ,而 无 须 修改 程序 代码 。 不 
仅 如 此 ,使 用 XML 文件 声明 的 界面 布局 ,用 户 还 能 够 通过 可 视 化 工具 直接 看 到 所 设计 的 
用 户 界 面 ,有 利于 加 快 界面 设计 的 过 程 ,并 且 为 界面 设计 与 开发 带 来 极 大 的 便利 性 。 


531 线性 布局 


线性 布局 (LinearLayout) 是 一 种 重要 的 界面 布局 中 ,也 是 经 常 使 用 的 界面 布局 。 在 
线性 布局 中 ,所 有 的 子 元 素 都 在 垂直 或 水 平方 向 按照 顺序 在 界面 上 排列 。 如 果 垂 直 排 
列 , 则 每 行 仅 包含 一 个 界面 元 素 ;同样 ,如 果 水 平 排列 , 则 每 列 仅 包 含 一 个 界面 元 素 。 
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图 5. 13 分 别 是 垂直 排列 的 线性 布局 和 水 平 排列 的 线性 布局 的 示例 。 


LinearLayout LinearLayout 


(a) 垂直 排列 (b) 水 平 排列 
图 5$.13 垂直 排列 和 水 平 排列 的 线性 布局 


下 面 将 用 一 个 简单 的 示例 说 明 如 何 使 用 线性 布局 ,示例 的 目标 是 实现 图 5. 3 所 显示 
的 用 户 界面 ,并 对 示例 中 用 到 的 界面 控件 进行 简单 的 介绍 。 

首先 创建 Android 工程 ,工程 名 称 是 LinearLayout, 包 名 称 是 edu. hrbeu. 
LinearLayout, Activity 名 称 为 LinearLayoutActivity。 为 了 能 够 完整 体验 创建 线性 布局 
的 过 程 ,这 里 首先 删除 Eclipse 自动 建立 的 /res/layout/main. xml 文件 ,然后 建立 垂直 排 
列 的 线性 布局 XML 文件 。 右 击 /res/layout 文件 夹 ,选择 New 一 Other.. == Android 
XML File 打开 XML 文件 建立 向 导 ,建立 命名 为 main. vertical. xml 的 XML 文件 ,类 型 
为 Layout ,不 需要 修改 资源 配置 ,保存 位 置 为 /res/layout,XML 文件 的 根 节 点 元 素 选择 
为 线性 布局 (LinearLayout) ,如 图 5.14 所 示 。 


© New Android XML File -—— “з 


New Android XML File 


Creates a new Android XML file. 


Resource Type: [Layout -| 
Project: [tineartayout z) 
File: main_vertica|xml B 


Root Element: 


[L JunearLayout 2 

ESuistview 

[*]MediaController 

а: MultiAutoCompleteTextView 
* NumberPicker 

EE ProgressBar 

Е QuickContactBadge 

8) RadioButton 


[Z]RadieGreup 


Ж RatingBar 


Q < Вак [Neu] [Enish |) (Cancel 


图 5.14 界面 可 视 化 编辑 器 
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双击 新 建立 的 /res/layout/main_vertical. xml 文件 ,Eclipse 将 自动 打开 界面 可 视 化 
编辑 器 ,如 图 5.15 所 示 。 可 视 化 编辑 器 顶部 是 配置 清单 ,可 以 选择 不 同 的 屏幕 尺寸 . 屏 
幕 方向 和 SDK 版 本 等 。 下 部 左 侧 是 界面 布局 和 界面 控件 ,用 户 可 以 将 需要 的 布局 和 控 
件 拖 中 到 右面 的 可 视 化 界面 中 ,并 修改 布局 和 控件 的 属性 。 右 侧 是 可 视 化 的 用 户 界面 ， 
能 够 实时 地 呈现 用 户 界 面 。 左 下角 的 Graphical Layout 和 main. vertical. xml 能 够 在 可 
视 化 编辑 器 和 XML 文件 编辑 器 之 间 切 换 。 


‚== 一 -| 日 Neusone -| 上 日 -| жне -| @tinearlyounciig = | Ф +| й + 


G» Form L. пе Ju аасааа 


C) Custom & Library Views 


ET) Graphical Layout | =] main. verticalml| 


5.15 界面 可 视 化 编辑 器 


在 Eclipse 右边 的 Outline 中 ,双击 LinearLayout, 打 开 线 性 布局 的 属性 编辑 器 。 线 
性 布局 的 排列 方法 由 Orientation 属性 控制 ,vertical 表示 垂直 排列 ,horizontal 表示 水 平 
排列 。 这 里 Orientation 属性 的 值 选择 vertical, 如 图 5. 16 所 示 ,表示 该 线性 布局 为 垂直 
排列 。 默 认 情 况 下 ,Layout height 的 值 为 wrap_content, 表 示 线 性 布局 高 度 等 于 所 有 子 
控件 的 高 度 总 和 ,也 就 是 线性 布局 的 高 度 会 刚好 将 所 有 子 控件 包含 其 中 。 将 Layout 
width 属性 的 值 改 为 fill_parent, 表 示 线 性 布局 宽度 等 于 父 控件 的 宽度 ,就 是 将 线性 布局 
在 横向 上 占据 父 控件 的 所 有 空间 。 


图 5.16 修改 线性 布局 的 Orientation 属性 


打开 XML 文件 编辑 器 ,main_vertical. xml 文件 的 代码 如 下 。 


«LinearLayout 


чо 0 ш M Hd 


< /LinearLayout» 


<?xml version- "1.0" encoding- "utf- 8"?» 


xmlns:android- "http: //schemas.android.com/apk/res/android" 


f 
Os Aoo 8 P ous 
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android:layout width="fill parent" 
android:layout _ height= "wrap content" 


android:orientation- "vertical"? 


第 2 行 代码 是 声明 XML Ж {ж 29 Z TER ыу. Ж 4,5,6 行 代码 是 在 属性 编辑 
器 中 修改 过 的 宽度 高度 和 排列 方式 的 属性 。 可 见 ,用 户 在 可 视 化 编辑 器 和 属性 编辑 器 
中 的 任何 修改 ,都 会 反映 在 XML 文件 中 ;反之 ,用 户 在 XML 文件 的 修改 ,也 会 影响 可 视 
化 编辑 器 和 属性 编辑 器 的 内 容 。 

然后 ,用 户 按照 TextView, EditText, Button, Button 的 顺序 ,将 4 个 界面 控件 先后 
拖 遇 到 可 视 化 编辑 器 中 ,所 有 控件 会 按照 拖 扰 的 顺序 显示 在 可 视 化 编辑 器 中 ,如 图 5. 17 
所 示 。 所 有 控件 都 自动 获取 控件 名 称 , 虽 然 在 可 视 化 编辑 器 中 两 个 按钮 显示 的 都 是 
Button ,但 在 控件 命名 上 分 别 被 命名 为 Buttonl 和 Button2, 


© Palette 


( 
|. Advanced 
J Other 


+ Palette 


> Form Widgets 


C) Custom & Library Views 


LinearLayout 


BUTTON 


BUTTON 


图 5.17 修改 线性 布局 的 Orientation 属性 


将 界面 控件 位 置 确定 后 ,按照 表 5. 1 在 属性 编辑 器 中 修改 界面 控件 的 属性 。 从 表 5. 1 


中 可 以 发 现 ,所 有 界面 控件 都 有 一 个 共同 的 属性 ID. ID 是 一 个 字符 串 ,编译 时 被 转换 为 


整数 ,在 代码 中 用 来 引用 界 列 


元 素 , 一 般 仅 代码 中 需要 动态 修改 的 界面 元 素 才 设置 ID, 


之 则 不 需要 设置 ID。 本 例 中 没有 在 代码 中 引用 任何 界面 元 素 , 因 此 完全 可 以 不 必 设置 
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ID, 但 为 了 说 明 ID 的 用 途 和 使 用 方法 ,在 本 例 中 为 所 有 的 界面 控件 设置 了 ID。 
表 5.1 线性 布局 界面 控件 的 属性 设置 


编 号 类 型 属 性 值 

Id @ 3- id/ label 
1 TextView 

Text 用 户 名 : 

14 @ 3- id/ entry 
2 EditText Layout width fill parent 

Text [null] 

Id (à) -- id/ok 
$ Button 

Text 确认 

Id (à) 3- id/ cancel 
4 Button 

Text 取消 


打开 XML 文件 编辑 器 ,查看 main_vertical. xml 文件 代码 ,发 现在 属性 编辑 器 内 填 
入 的 内 容 已 经 正确 写 信 了 XML 文件 ,此 时 main. vertical. xml 文件 的 全 部 代码 如 下 。 


1 <?xml version- "1.0" encoding- "utf- 8"? > 


2 «LinearLayout 


3 xmlns:android- "http: //schemas.android.com/apk/res/android" 
4 android:layout width-"fill parent" 

5 android:layout height- "wrap content" 

6 android:orientation- "vertical"» 

7 

8 « TextView android:id- "ё * id/label" 

9 android:layout width- "wrap content" 
10 android:layout height- "wrap content" 
11 android:text- "JH P 4 :" > 

12 « /TextView» 

33 «EditText android:id- "ё + id/entry" 

14 android:layout height- "wrap content" 
15 android:layout width- "fill parent" 
16 < /EditText» 

XT «Button android:id- "ё + id/ok" 

18 android:layout width- "wrap content" 
19 android:layout height- "wrap content" 
20 android:text- "Wf iA "> 

21. « /Button» 

22 «Button android:id- "ё + id/cancel" 

23 android:layout width="wrap content" 


24 android:layout _ height= "wrap content" 


z@= Android 用 户 界面 
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25 android:text= "取消" > 
26 < /Button> 


27 </LinearLayout> 


最 后 ,将 LinearLayout. java 文件 中 的 setContentView CR. layout. main) , 更 改 为 
setContentView(R. layout. main_vertical) 。 运 行 后 的 结果 如 图 5. 13(a) 所 示 。 

建立 横向 排列 的 线性 布局 过 程 与 上 述 的 纵向 线性 布局 非常 相似 ,注意 以 下 几 个 关键 
点 即 可 ， 

(D 建立 main. horizontal. xml 文件 ; 

@ 线性 布局 的 Orientation 属性 的 值 设 置 为 horizontal; 

( 将 EditText 的 Layout. width 属性 的 值 设 置 为 wrap_content; 

(D 将 LinearLayout. java 文件 中 的 setContentView(R. layout. main. vertical) 修改 


为 setContentView(R. layout. main_horizontal) 。 


532 框架 布局 


框架 布局 (FrameLayout) 是 最 简单 的 界面 布局 ,用 来 存放 一 个 元 素 的 空白 空间 , 且 子 
元 素 的 位 置 是 不 能 够 指定 的 ,只 能 够 放置 在 空白 空间 的 左上 角 。 如 果 有 多 个 子 元 素 ,后 
放置 的 子 元 素 将 遮挡 先 放置 的 子 元 素 。 

为 了 更 好 地 理解 框架 布局 ,这 里 使 用 Android SDK 中 提供 的 层级 观察 器 (Hierarchy 
Viewer) 进 一 步 分 析 界 面 布 局 。 层 级 观察 器 能 够 对 用 户 界面 进行 分 析 和 调试 ,并 以 图 形 
化 的 方式 展示 树 形 结构 的 界面 布局 ,另外 ,还 提供 了 一 个 精确 的 像素 观察 器 (Pixel 
Perfect View) ,以 栅 格 的 方式 详细 观察 放大 后 的 界面 。 

在 模拟 器 上 运行 上 一 小 节 垂 直 排列 的 线性 布局 示例 ,在 层级 观察 器 中 获得 示例 界面 
布局 的 树 形 结构 图 ,如 图 5. 18 所 示 。 

结合 界面 布局 的 树 形 结构 图 (图 5. 18) 和 示意 图 (图 5. 19) ,分 析 不 同 界面 布局 和 界 
面 控件 的 区 域 边界 。 用 户 界面 的 根 节点 (并 0@43599ee0) 是 线性 布局 ,其 边界 是 整个 界 
面 ,也 就 是 示意 图 的 最 外 层 的 实心 线 。 根 节点 右 侧 的 子 节点 (#0@43599a730) 是 框架 布 
局 , 仅 有 一 个 节点 元 素 (# 0 @ 4359ad18) , 这 个 子 元 素 是 TextView 控件 ,用 来 显示 
Android 应 用 程序 名 称 , 其 边界 是 示意 图 中 的 区 域 1。 因 此 框架 布局 元 素 #0@ 
43599a730 的 边界 是 同 区 域 1 的 高 度 相同 ,宽度 充满 整个 根 节点 的 区 域 。 这 两 个 界面 元 
素 是 系统 自动 生成 的 ,一 般 情况 下 用 户 不 能 够 修改 和 编辑 。 

根 节点 左 侧 的 子 节点 (#1@4359b858) 也 是 框架 布局 ,边界 是 区 域 2 到 区 域 7 的 全 
部 空间 。 其 下 仅 有 一 个 子 节点 (#0@4359bd60) 元 素 是 线性 布局 ,因为 线性 布局 的 
Layout width 属性 设置 为 fill_parent,Layout height 属性 设置 为 wrap_content, 因 此 该 线 
性 布局 的 宽度 就 是 其 父 节 点 并 1@4359b858 的 宽度 ,高 度 等 于 所 有 子 节点 元 素 的 高 度 之 
和 。 线 性 布局 #0@4359bd60 的 四 个 子 节点 元 素 #0@4359bfa8、#1@4359c5f8、#2@ 
43594548 fil # 3@4359de18 的 边界 ,分 别 是 界面 布局 示意 图 中 的 区 域 2、 区 域 3、 区 域 4 和 
区 域 5。 
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PhoneWindow$DecorView 
#0@43599458 
NO ID 


LinearLayout 


#0@43599ee0 
NO ID 
FrameLayout 
#1(@4359b858 
id/content 
LinearLayout 
#0@4359bd60 
NO ID 
TextView EditText Button Button 
#0@4359bfa8 #1(@4359c5f8 #2(@4359d5d8 #3@4359de18 
id/label id/entry id/ok id/cancel 


图 5.18 界面 布局 的 树 形 结构 图 


图 5.19 界面 布局 的 示意 图 


FrameLayout 
#0@4359а730 
NO ID 


TextView 
#0@4359ad18 
id/title 
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533 表格 布局 


表格 布局 (TableLayout) 也 是 一 种 常用 的 界面 布局 , 它 将 屏幕 划分 为 表格 ,通过 指定 
行 和 列 可 以 将 界面 元 素 添加 到 表格 中 。 对 比 网 格 布局 的 示意 图 (图 5. 20) 和 效果 图 
(图 5. 21) ,可 以 发 现 网 格 的 边界 对 用 户 是 不 可 见 的 。 表 格 布局 还 支持 艇 套 , 可 以 将 另 一 
个 表格 布局 放置 在 前 一 个 表格 布局 的 网 格 中 ,也 可 以 在 表格 布局 中 添加 其 他 界面 布局 ， 
例如 线性 布局 .相对 布局 等 。 


Row1 | TextView | | EditText | 
Row 2 ( Button | ( Button | 


表格 布局 


图 5.20 表格 布局 的 示意 图 


参照 5. 3. 2 节 的 界面 示例 ,这 里 使 用 表格 布局 实现 用 户 界面 。 建 立 一 个 新 的 
Android 工程 ,工程 名 称 为 TableLayout. TE / res/layout/main. xml 文件 中 设计 基于 表格 
布局 的 用 户 界 面 。 在 表格 布局 中 设计 一 个 2X2 的 网 格 , 每 个 网 格 中 置 放 一 个 界面 控件 ， 
实现 效果 如 图 5. 21 所 示 。 

建立 表格 布局 的 示例 并 不 困难 ,参照 5. 3. 2 节 的 示例 可 以 很 容易 实现 ,但 要 注意 以 
ЛА: 

向 界面 中 添加 一 个 表格 布局 ,无 须 修改 布局 的 属性 值 。 其 中 , Id 属性 为 
TableLayout01,Layout width 和 Layout height 属性 都 为 wrap_content。 

© 在 Outline 视图 中 ,在 TableLayout01 上 右 击 ,选择 Add Row 向 TableLayout01 
中 添加 两 个 TableRow。TableRow 代表 一 个 单独 的 行 , 每 行 被 划分 为 几 个 小 的 单元 , 单 
元 中 可 以 添加 一 个 界面 控件 。 其 中 ,Id 属性 分 别 为 TableRow01 和 TableRow02. Layout 
_width 和 Layout_height 属性 都 为 wrap content, 

@ 在 界面 可 视 化 编辑 器 上 ,向 TableRow01 中 拖 电 TextView 和 EditText ,如 图 5. 22 
所 示 。 


by 


[Ë] Task List (BE Outline Е Жө) 
В TableLayoutol 
H TableRow01 

Ab label ( 


TableLayout 


© entry 
E TableRow02 
Ë ok (Button) - "W 
Ë= Button02 - 


图 5.21 表格 布局 的 效果 图 图 5.22 Outline 视图 中 的 表格 布局 
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Ф 在 界面 可 视 化 编辑 器 上 ,再 向 TableRow02 ri 8 PA Button. 
© 参考 表 5. 2 设置 TableRow 中 4 个 界面 控件 的 属性 值 。 


表 5.2 表格 布局 界面 控件 的 属性 设置 


编 号 类 型 属 性 值 

Id @ +id/label 
Text 用 户 名 : 

ET TextView Gravity right 
Padding 3dip 
Layout width 160dip 
Id @ 3- id/entry 
Text [null] 

2 EditText 
Padding 3dip 
Layout_width 160dip 
14 (à 3- id/ok 

3 Button Text 确认 
Padding 3dip 
Id @ -Е1а/сапсе1 

4 Button Text 取消 
Padding 3dip 


main. xml 文件 的 完整 代码 如 下 。 


* «?xml version- "1.0" encoding- "utf- 8"?» 

2 

3 < TableLayout android:id- "@ + id/TableLayout01" 

4 android:layout width- "fill parent" 

5 android:layout height- "fill parent" 

6 xmlns:android- "http: //schemas.android.com/apk/res/android"» 
7 « TableRow android:id- "ё + id/TableRow01" 

8 android:layout width- "wrap content" 

9 android:layout height- "wrap content"» 

10 < TextView android:id- "ё + id/label" 

11 android:layout height="wrap content" 
12 android:layout width= "160аір" 

13 android:gravity- "right" 

14 android:text- "用 户 名 :" 

15 android:padding- "3dip" > 


16 < /TextView» 
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«EditText android:id- "ё + id/entry" 
android:layout height- "wrap content" 
android:layout width- "l60dip" 
android:padding- "3dip" » 

< /EditText^ 

« /TableRow» 

< TableRow android:id- "8 + id/TableRow02" 
android:layout width- "wrap content" 
android:layout height- "wrap content"» 

« Button android:id- "ё + id/ok" 
android:layout height- "wrap content" 
android:padding- "3dip" 
android:text- "确认 "> 

< /Button» 

< Button android:id- "@+id/Button02" 
android:layout width- "wrap content" 
android:layout height- "wrap content" 
android:padding- "3dip" 
android:text- "ЖЇН "> 

« /Button» 

< /TableRow» 
< /TableLayout» 


第 3 行 代 码 使 用 了 二 TableLayout 二 标签 声明 表格 布局 ;第 7 行 和 第 23 行 代码 声明 


了 两 个 TableRow 元 素 ,用 来 表示 布局 中 的 两 行 ; 第 12 行 利用 宽度 属性 android:layout_ 


width ,将 TextView 元 素 的 宽度 指定 为 160dip; 第 13 行使 用 属性 android: gravity, 将 
TextView 中 的 文字 对 齐 方式 指定 为 右 对 齐 ; 第 15 行使 用 属性 android: padding, 声 明 
TextView 元 素 与 其 他 元 素 的 间隔 距离 为 3dip。 
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相对 布局 (RelativeLayout) 是 一 种 非常 灵活 的 布局 方式 ,能 够 通过 指定 界面 元 素 与 
其 他 元 素 的 相对 位 置 关系 ,确定 界面 中 所 有 元 素 的 布局 位 置 。 相 对 布局 和 线性 布局 有 着 
共同 的 优点 ,能够 最 大 程度 保证 在 各 种 屏幕 类 型 的 手机 上 正确 显示 界面 布局 。 


图 5. 23 是 相对 布局 的 一 个 示例 ,下 面 先 用 文 


字 对 界 


首先 添加 TextView 控件 (“用 户 名 ”), 相 对 布局 会 
将 TextView 控件 放置 在 屏幕 的 最 上 方 ;然后 添加 
EditText 控件 (输入 框 ), 并 声明 该 控件 的 位 置 在 
TextView 控件 的 下 方 ,相对 布局 会 根据 TextView 


Н 


元 素 的 添加 顺序 和 相互 关系 进行 描述 。 


RelativeLayout 


的 位 置 确定 EditText 控件 的 位 置 ;之 后 添加 第 一 图 5.23 相对 布局 
个 Button 控件 (“取消 ”按钮 ) ,声明 在 EditText 控 
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件 的 下 方 , 且 在 父 控件 的 最 右边 ;最 后 ,添加 第 二 个 Button 控件 (“确认 ”按钮 ) ,声明 该 控 
件 在 第 一 个 Button 控件 的 左 方 . 且 与 第 一 个 Button 控件 处 于 相同 的 水 平 位 置 。 
main. xml 文件 的 完整 代码 如 下 。 


£ <?xml version= "1.0" encoding- "utf- 8"?> 

2 

3 <RelativeLayout android:id- "@+id/RelativeLayout01" 
4 android:layout width= "fill parent" 

5 android:layout height- "fill parent" 

6 xmlns:android- "http://schemas .android.com/apk/res/android"» 
7 « TextView android:id- "ё * id/label" 

8 android:layout height- "wrap content" 
9 android:layout width- "fill parent" 
10 android:text- "用 户 名 :"» 

1 < /TextView» 

12 «EditText android:id- "ё + id/entry" 

13 android:layout_height= "wrap content" 
14 android:layout width="fill parent" 
15 android:layout below="@ іа/1аре1"> 

16 < /EditText» 

17 < Button android:id="@ +id/cancel" 

18 android:layout_height= "wrap content" 
19 android:layout width- "wrap content" 
20 android:layout alignParentRight- "true" 
21 android:layout marginLeft- "l0dip" 

22 android:layout below- "ё id/entry" 

23 android:text- "取消 "> 

24 < /Button> 

25 «Button android:id- "ё + id/ok" 

26 android:layout height- "wrap content" 
21 android:layout width- "wrap content" 
28 android:layout toLeftOf- "ё id/cancel" 
29 android:layout alignTop- "6 id/cancel" 
30 android:text- "确认 "> 

31 < /Button> 


32 </RelativeLayout> 


在 上 面 的 代码 中 ,首先 在 第 3 ITEM Y < RelativeLayout > fp Ж E B] — HX 1р J; 
第 15 行使 用 位 置 属性 android:layout_below ,确定 Edit Text 控件 在 ID 为 label 的 元 素 下 
方 ;第 20 行使 用 属性 android:layout_alignParentRight, 声 明 该 元 素 与 其 父 元 素 的 右边 边 
界 对 齐 ; 第 21 行使 用 属性 android:layout_marginLeft ,将 该 元 素 相 左 移动 10dip; 第 22 行 
声明 该 元 素 在 ID 为 entry 的 元 素 下 方 ;第 28 行 声明 使 用 属性 android:layout_toLeftOf， 
声明 该 元 素 在 ID 为 cancel 元 素 的 左边 ;第 29 行使 用 属性 android:layout_alignTop ,声明 
该 元 素 与 ID 为 cancel 的 元 素 在 相同 的 水 平 位 置 。 
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535 绝对 布局 


绝对 布局 (AbsoluteLayout) 能 通过 指定 界面 元 素 的 坐标 位 置 ,来 确定 用 户 界面 的 整 
体 布 局 。 绝 对 布局 是 一 种 不 推荐 使 用 的 界面 布局 .因为 通过 绝对 位 置 确定 的 界面 元 素 ， 
Android 系统 不 能 够 根据 不 同 屏幕 对 界面 元 素 的 
位 置 进行 调整 ,降低 了 界面 布局 对 不 同类 型 和 尺 
才 屏 幕 的 适应 能 力 。 使 用 绝对 布局 往往 在 目标 手 
机 上 非常 完美 ,但 在 其 他 不 同类 型 的 手机 上 ,界面 
布局 却 变 得 混乱 不 堪 。 

图 5.24 是 绝对 布局 的 一 个 示例 ,每 一 个 界面 
控件 都 必须 指定 坐标 (X,Y) ,例如 “确认 ”按钮 的 
坐标 是 (40, 120),“ 取 消 ” 按 钮 的 坐标 是 (120， 
120) 。 坐 标 原点 (0,0) 在 屏幕 的 左上 角 。 


AbsoluteLayout 


下 面 给 出 main. xml 文件 的 完整 代码 。 

£ «?xml version- "1.0" encoding- "utf- 8"?» 

2 

3  «AbsoluteLayout android:id- "ё + id/AbsoluteLayout01l" 
4 android:layout width- "fill parent" 

5 android:layout height- "fill parent" 

6 xmlns:android- "http: //schemas .android.com/apk/res/android"» 
7 « TextView android:id-"Q + іа/1аре1" 

8 android:layout х= "40dip" 

9 android:layout у= "40dip" 

10 android:layout height- "wrap content" 
11 android:layout width= "wrap content" 
12 android:text- "用 户 名 :"> 

13 < /TextView» 

14 «EditText android:id="@+ id/entry" 

15 android:layout x-"40dip" 

16 android:layout y-"60dip" 

17 android:layout height- "wrap content" 
18 android:layout width- "150аір"> 

19 < /EditText^ 

20 «Button android:id- "ё + id/ok" 

21 android:layout width- "70dip" 

22 android:layout height- "wrap content" 
23 android:layout x-"40dip" 

24 android:layout у= "120аір" 

25 android:text- "ЙА "> 

26 < /Button> 


27 «Button android:id="@+ id/cancel" 
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28 android:layout width="70dip" 

29 android:layout height="wrap content" 
30 android:layout x-"120dip" 

31 android:layout у= "120dip" 

32 android:text- "Hil "> 

33 « /Button» 


34 «/Bbsolutelayout» 


536 网 格 布局 


网 格 布局 (GridLayout) 是 Android SDK 4. 0( API Level 14) 新 支持 的 布局 方式 ,将 用 
户 界面 划分 为 网 格 , 界面 元 素 可 随意 摆 放 在 这 些 网 格 中 。 网 格 布局 比 表格 布局 
(TableLayout) 在 界面 设计 上 更 加 灵活 ,在 网 格 布局 中 界面 元 素 可 以 占用 多 个 网 格 的 ,而 
在 表格 布局 却 无 法 实现 ,只 能 将 界面 元 素 指定 在 一 个 表格 行 (TableRow) 中 ,不 能 跨越 多 
个 表格 行 。 

下 面 用 GroidLayoutDemo 示例 说 明 网 格 布局 的 使 用 方法 。 图 5. 25(a) 和 图 5. 25(b) 
分 别 是 在 Eclipse 界面 设计 器 中 的 界面 图 示 和 在 Android 模拟 器 运行 后 的 用 户 界面 。 


GridLayoutDemo GridLayoutDemo 


(a) 界面 设计 器 图 示 (b) 模拟 器 运行 结 量 


5.25 GroidLayoutDemo 示例 


在 界面 设计 器 中 可 以 看 到 虚线 网 格 ,但 在 模拟 器 的 运行 结果 中 是 看 不 到 的 。 网 格 布 
局 将 界面 划分 成 多 个 块 , 这 些 块 是 根据 界面 元 素 动 态 划 分 的 。 具 体 的 讲 ， 
GroidLayoutDemo 示例 的 左边 第 一 列 的 宽度 ,是 综合 分 析 在 第 一 列 中 的 两 个 界面 元 素 
“用 户 名 ”和 “密码 ”TextView 的 宽度 而 进行 设 定 的 ,选择 两 个 元 素 中 最 宽 元 素 的 宽度 , fE 
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为 第 一 列 的 宽度 。 同 样 ,最 上 方 第 一 行 的 高 度 , 也 是 分 析 * 这 是 关于 GridLayout 的 示例 ” 
这 个 Text View 元 素 的 高 度 进行 设 定 的。 因此 ,网 格 布局 中 行 的 高 度 和 列 的 宽度 ,完全 取 


决 于 


例 ” 


F 本 行 或 本 列 中 高 度 最 高 或 宽 对 最 宽 的 界面 元 素 。 
但 在 网 格 布 局 中 ,界面 元 素 是 可 以 跨越 多 个 块 的 ,例如 “这 是 关于 GridLayout 的 示 
这 个 TextView 元 素 就 占据 了 纵向 4 个 块 用 户 名 : "这 个 TextView 在 纵向 仅 占 用 


了 


个 块 ,而 用 户 名 输入 框 控 件 EditText 在 纵向 上 占用 了 2 个 块 。 这 个 示例 中 没有 横向 


占用 多 个 块 的 界面 元 素 ,但 这 样 设计 在 网 格 布局 中 是 允许 的 。 


下 面 给 出 main. xml 文件 的 全 部 代码 。 


ji <?xml version- "1.0" encoding- "utf- 8"?» 

z <GridLayout 

3 xmlns:android- "http://schemas .android.com/apk/res/android" 
4 

5 android:layout width- "match parent" 

6 android:layout height- "match parent" 

T android:useDefaultMargins= "true" 

8 android:columnCount="4" > 

9 

10 < TextView 

11 android:layout_columnSpan= "4" 

12 android:layout gravity- "center horizontal" 
13 android:text- "这 是 关于 GroidLayout 的 示例 " 
14 android:textSize= "20dip" /> 

15 

16 <TextView 

17 android:text= "HH P! 4 :" 

18 android:layout gravity- "right" /> 
19 

20 «EditText 

21 android:ems= "8" 

22 android:layout columnSpan- "2" /> 
23 

24 < TextView 

25 android:text- "密码 :" 

26 android:layout column- "0" 

27 android:layout gravity="right"/> 
28 

29 «EditText 

30 android:ems- "8" 

31 android:layout columnSpan- "2" /> 
3 

33 «Button 


34 android:text- "清空 输入 " 
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35 android:layout column- "1" 

36 android:layout gravity- "fill horizontal"/» 
37 

38 «Button 

39 android:text- "下 一 步 " 

40 android:layout column- "2" 

2 android:layout gravity-"fill horizontal"/» 


42 


43 «/GridLayout» 


代码 第 7 行 的 useDefaultMargins 表示 网 格 布局 中 的 所 有 元 素 都 遵循 默认 的 边缘 规 
则 ,就 是 说 所 有 元 素 之 间 都 会 留 有 一 定 的 边界 空间 。 代 码 第 8 行 的 columnCount 表示 纵 
向 分 为 4 列 ,从 第 0 列 到 第 3 列 ,程序 开发 人 员 也 可 以 在 这 里 定义 横向 的 行 数 , 使 用 
rowCount 属性 。 

代码 第 11 行 的 layout_columnSpan 属性 表示 TeixtView 控件 所 占据 的 列 的 数量 。 
代码 第 12 行 的 layout_gravity= center_horizontal 表示 文字 内 容 在 所 占据 的 块 中 居中 
显示 。 

代码 第 10 行 到 第 14 行 定义 了 第 一 个 界面 控件 ,虽然 定义 了 纵向 所 占据 的 块 的 数 
量 ,但 却 没有 定义 元 素 起 始 位 置 所 在 的 块 , 原 因 是 网 格 布局 中 第 1 个 元 素 默 认 在 第 0 行 
第 0 列 。 

代码 第 16 行 到 第 18 行 定义 了 第 2 个 界面 控件 ,仍然 没有 定义 元 素 起 始 位 置 所 在 的 
块 。 根 据 网 格 布局 界面 元 素 的 排 布 规则 ,如 果 没 有 明确 说 明 元 素 所 在 的 块 ,那么 当前 元 
素 会 放置 在 前 一 个 元 素 的 同一 行 右 侧 的 块 上 ;如 果 前 一 个 元 素 已 经 是 这 一 行 的 末尾 块 ， 
则 当前 元 素 放置 在 下 一 行 的 第 一 个 块 上 ;如 果 当 前 元 素 在 纵向 上 占据 多 个 块 ,而 前 一 个 
元 素 右 侧 没有 足够 数量 的 块 , 则 当前 元 素 的 起 始 位 置 也 会 放置 在 下 一 行 的 第 一 个 块 上 。 

代码 第 26 行 的 layout_column 属性 表示 当前 元 素 列 的 起 始 位 置 。 如 果 layout_ 
column 所 指定 的 列 的 位 置 在 当前 行 已 经 被 占用 , 则 当前 元 素 也 会 放置 在 下 一 行 的 这 一 
列 中 。 

在 网 格 布局 中 没有 定义 的 属性 是 具有 默认 值 的 ,具体 默认 值 可 以 参考 表 5. 3。 


表 5.3 网 格 布局 中 属性 的 默认 值 


属 性 默 认 值 备 注 

width WRAP_CONTENT 

height WRAP_CONTENT 

topMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
leftMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
bottomMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
rightMargin 0 当 用 户 将 useDefaultMargins 设置 为 false 
rowSpec. row UNDEFINED 
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续 表 
属 性 默 认 {Н 备 ik 
rowSpec. rowSpan 1 
rowSpec. alignment BASELINE 
columnSpec. column UNDEFINED 
columnSpec. columnSpan 1 
columnSpec. alignment LEFT 
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菜单 是 应 用 程序 中 非常 重要 的 组 成 部 分 ,能 够 在 不 占用 界面 空间 的 前 提 下 ,为 应 用 
程序 提供 统一 的 选择 功能 和 设置 界面 ,并 为 程序 开发 人 员 提 供 易 于 使 用 的 编程 接口 。 
Android 系统 支持 三 种 菜单 模式 ,分 别 是 选项 菜单 (Option Menu)、 子 菜单 (Submenu) 和 
快捷 菜单 (Context Menu), 
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Android 程序 的 菜单 可 以 在 代码 中 动态 生成 ,也 可 以 使 用 XML 文件 制作 菜单 资源 ， 
然后 通过 inflate() 函 数 映 射 到 程序 代码 中 。 使 用 XML 文件 描述 菜单 是 较 好 的 选择 ,可 
以 将 菜单 的 内 容 与 代码 分 离 , 且 有 利于 分 析 和 调整 菜单 结构 。 

下 面 的 代码 是 MenuResource 示例 main menu. xml 文件 的 全 部 代码 。 


1 <?xml version- "1.0" encoding- "utf- 8"?» 
2 «menu xmlns:android- "http: //schemas .android.com/apk/res/android"» 
3 «item android:id- "@+id/main menu 0" 
4 android:icon- "ё drawable/picO" 
5 android:title- "打印 " /> 

6 «item android:id="@ +id/main menu 1" 
T апагоіа:ісоп= "ё drawable/pic1" 
8 android:title- "Й" /> 

9 «item android:id- " + id/main menu 2" 
10 android:icon- "ё drawable/pic2" 
ad: android:title- "邮件 " /> 

12 «item android:id="@+ іа/таіп menu 3" 
13 android:icon- "ё drawable/pic3" 
14 android:title- "设置 " /> 

15 «item android:id="@ +id/main menu 4" 
16 android:icon- "ё drawable/pic4" 
17 android:title- "订阅 " /> 


18 «/menu» 
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上 面 的 代码 生成 的 菜单 如 图 5. 26 Bron ,生成 
具有 5 个子 项 的 菜单 。 代 码 第 2 行 的 menu ЖЖ 
单 的 容器 ,菜单 资源 必须 以 menu 作为 根 元 素 。{ 
码 第 3 fT item 是 菜单 项 ,其 属性 值 id icon 和 ^ 

分 别 是 菜单 项 的 ID 值 `. 图 标 和 标题 。 代 码 第 4 fT 
以 及 后 续 的 代码 中 ,虽然 定义 了 菜单 项 的 图 标 , 但 
菜单 资源 选择 的 菜单 模式 不 同 , 菜 单项 图 标 可 能 
会 不 显示 。MenuResource 示例 使 用 的 是 选项 菜 
单 , 因 此 菜单 项 的 图 标 没 有 显示 ,而 仅 显 示 了 菜单 5.26 MenuResource 示例 界面 
项 的 标题 。 
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选项 菜单 是 一 种 经 常 被 使 用 的 Android 系统 菜单 ,用 户 可 以 通过 菜单 键 (MENU 
key) 打 开 选 项 菜单 。 

在 Android 2.3 之 前 的 系统 中 ,选项 菜单 分 为 图 标 菜单 (Icon Menu) 和 浮动 菜单 
(Overflow Menu) ,通过 菜单 键 直接 打开 的 是 图 标 菜单 ,如 图 5.27 所 示 。 顾 名 思 义 ,图标 
菜单 就 是 能 够 同时 显示 文字 和 图 标的 菜单 ,最 多 支持 6 个 子 项 ,如 果子 项 多 于 6 个 , 则 需 
要 扩展 菜单 显示 其 他 的 子 项 。 

浮动 菜单 是 垂直 的 列表 型 菜单 ,如 图 5. 28 所 示 , 仅 在 图 标 菜单 子 项 多 于 6 个 时 才 出 
a 通过 点 击 图 标 菜单 最 后 的 子 项 More 才能 打开 。 浮 动 菜单 不 能 够 显示 图 标 , 但 支持 单 

选 框 和 复 选 框 ;相反 ,图 标 菜单 支持 显示 图 标 , 但 不 支持 单 选 框 和 复 选 框 。 


MenuResource 


菜单 子 项 5 

菜单 子 项 6 

菜单 子 项 7 

菜单 子 项 8 м 
菜单 子 项 0 菜单 子 项 1 菜单 子 项 2 
^ | 菜单 子 项 9 (м 
š a 
菜单 子 项 3 菜单 子 项 4 More XM DIO v 

图 5.27 图 标 菜单 图 5.28 浮动 菜单 


在 Android 4.0 系统 中 ,选项 菜单 只 出 现 浮动 菜单 ,而 不 再 出 现 如 图 5. 27 的 选项 菜 
单 , 图 标 菜 单 的 部 分 功能 由 操作 栏 代替 实现 。 

在 Android 4.0 系统 中 ,Activity 在 创建 时 便 会 调用 onCreateOptionsMenu O 函数 初 
始 化 自身 的 菜单 系统 。 在 Activity 的 整个 生命 周期 中 ,选项 菜单 是 一 直 被 重复 利用 的 ， 
直到 Activity 被 销毁 。 在 Android 2. 3 之 前 的 系统 中 ,onCreateOptionsMenu() 函 数 只 


z@= Android 用 户 界面 


119 


在 用 户 点 击 菜单 键 后 才 被 调用 ,就 是 说 选项 菜单 是 在 需要 的 时 候 才 被 创建 的 。 但 
Android 4. 0 系统 需要 在 程序 的 顶部 显示 操作 栏 ,操作 栏 的 初始 化 代码 也 在 
onCreateOptionsMenu O 函数 中 ,因此 该 函数 在 Activity 创建 时 就 会 被 调用 。 

重 载 onCreateOptionsMenu() 函 数 主要 目的 是 初始 化 菜单 ,可 以 使 用 XML 文件 的 
菜单 资源 ,也 可 以 使 用 代码 动态 加 载 菜单 。 下 面 的 代码 是 使 用 main_menu. xml 文件 作 
为 菜单 资源 初始 化 Activity 的 菜单 。 


@ Override 

public boolean onCreateOptionsMenu (Menu menu) { 
MenuInflater inflater- getMenuInflater(); 
inflater.inflate (R.menu.main menu, menu); 


return true; 
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} 


在 用 户 选择 菜单 项 后 ,Android 系统 会 调用 onOptionsItemSelected() 函 数 , 一 般 将 菜单 
选择 事件 的 响应 代码 放置 在 onOptionsItemSelected() 函数 中 。onOptionsItemSelected( ) 函数 
会 返回 用 户 选 择 的 MenuItem, 可 以 通过 getItemId O 函数 获取 Menultem 的 ID, 这 个 ID 就 是 
用 户 在 XML 文件 中 为 每 个 菜单 项 所 设 定 的 android:id 属性 值 。 

onOptionsItemSelected O 函数 在 每 次 用 户 点 击 菜单 子 项 时 都 会 被 调用 。 下 面 的 代码 
说 明 如 何 通过 菜单 子 项 的 子 项 ID 执行 不 同 的 操作 。 


1 @Оуеггїде 

2 public boolean onOptionsItemSelected (MenuItem item) { 

3 TextView label= (TextView)findViewById (R.id.label); 

4 

5 Switch (item.getItemId()){ 

6 case R.id.main menu 0: 

7 label.setText ("打印 ,菜单 ID:"+ item.getItemId()); 
8 return true; 

9 case R.id.main menu 1: 

10 label.setText ("新 建 ,菜单 ID:"+ item.getItemId()); 
11 return true; 

12 case R.id.main menu 2: 

33 label.setText ("邮件 ,菜单 rp:"+item.getItemId()); 
14 return true; 

15 сазе R.id.main menu 3: 

16 label.setText ("设置 ,菜单 ID:"+ item.getItemId()); 
17 return true; 

18 case R.id.main menu 4: 

19 label.setText ("订阅 ,菜单 rp:"+item.getItemId()); 
20 return true; 

21 default: 


22 return false; 
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函数 onOptionsItemSelected() 的 返回 值 表 示 是 否 需 求 其 他 事件 处 理 函 数 菜 单 选 择 
事件 进行 处 理 ,如 果 不 需要 其 他 函数 处 理 该 事件 则 返回 true, 和 否则 返回 false, 

代码 第 5 行 的 getltemld() 函数 获取 被 选择 菜单 子 项 的 ID。 代 码 第 7 行 通过 在 
XML 文件 中 定义 的 菜单 ID 与 getltemld( неее нене ян 配 。 

选项 菜单 的 代码 可 参考 OptionsMenu 示例 ,程序 运行 后 通过 点 击 菜单 键 可 以 调 出 选 
项 菜单 ,如 图 5. 29(a) 所 示 。 


OptionMenu OptionMenu2 


(a) OptionsMenu 示 例 (b) OptionsMenu2 示 例 
5.29 选项 菜单 示例 界面 


开发 人 员 除 了 可 以 使 用 XML 文件 的 菜单 资源 以 外 ,还 可 以 在 代码 中 动态 生成 菜单 。 
OptionsMenu2 ж 例 说 明 如 何 使 用 代码 生成 的 菜单 ,所 生成 的 菜单 内 容 与 OptionsMenu 
示例 的 菜单 完全 相同 ,如 图 5.26(b) 所 示 。 
开发 人 员 首 先 要 在 代码 中 定义 菜单 ID ,然后 在 onCreateOptionsMenu O 函数 中 添加 
选项 菜单 ,并 设置 菜单 的 标题 和 图 标 等 
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1 final static int MENU 00-Menu.FIRST; 


N 


final static int MENU 01=Menu.FIRST+1; 


3 final static int MENU 02=Menu.FIRST+ 2; 

4 final static int MENU 03-Menu.FIRST-* 3; 

5 final static int MENU 04-Menu.FIRST- 4; 

6 

Т @ Override 

8 public boolean onCreateOptionsMenu (Menu menu) ( 

9 menu.add(0,MENU 00,0, "打印 ") .setIcon (R.drawable .ріс0); 
10 menu.add(0,MENU 01,1, "新建 ") .setIcon (R.drawable.picl); 
11 menu.add(0,MENU 02,2, "邮件 ") -setIcon (R.drawable.pic2); 
12 menu.add(0,MENU 03,3, "设置 ") .setIcon (R.drawable.pic3) ; 
13 menu.add(0,MENU 04,4, "订阅 ") .setIcon (R. drawable.pic4); 
14 return true; 

45. j 


一 般 将 菜单 项 的 ID 定义 成 静态 常量 (代码 第 1 行 至 第 5 行 ), 并 使 用 静态 常量 


^. 
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Menu. FIRST( 整 数 类 型 , 值 为 1) 定义 第 一 个 菜单 子 项 ,以 后 的 菜单 项 仅 需 在 Menu 
.FIRST 增 加 相应 的 数值 即 可 。 

在 onCreateOptionsMenu() 函 数 中 ,函数 的 返回 类 型 为 布尔 值 (代码 第 14 行 ) ,返回 
true 则 可 显示 在 函数 中 设置 的 菜单 .否则 将 不 能 够 显示 菜单 。 

Menu 对 象 作 为 一 个 参数 被 传递 到 函数 内 部 ,因此 在 onCreateOptionsMenu O 函数 
中 ,用 户 可 以 使 用 Menu 对 象 的 add() 函 数 添加 菜单 项 。 

add() 函 数 的 语法 如 下 。 


MenuItem android.view.Menu.add (int groupId, int itemId, int order, CharSequence title) 


add O KUIS 1 个 参数 groupId 是 组 ID, 用 以 批量 地 对 菜单 子 项 进行 处 理 和 排序 ; 
第 2 个 参数 itemId 是 子 项 ID, 是 每 一 个 菜单 子 项 的 唯一 标识 ,通过 子 项 ID 使 应 用 程序 
位 到 用 户 所 选择 的 菜单 子 项 ;第 3 个 参数 order 是 定义 菜单 子 项 在 选项 菜单 中 的 
排列 顺序 ;第 4 个 参数 title 是 菜单 子 项 所 显示 的 标题 。 

另外 ,通过 setIcon() 函 数 可 以 为 菜单 子 项 添加 图 标 ,需要 将 图 像 资源 文件 复制 到 
/res/drawable 目录 下 。 
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子 菜单 就 是 二 级 菜单 ,用户 点 击 选项 菜单 或 快捷 菜单 中 的 菜单 项 ,就 可 以 打开 子 菜 
单 。 当 程序 具有 大 量 的 功能 时 ,可 以 将 相似 的 功能 划分 成 组 ,选项 菜单 可 用 来 表示 功能 
组 ,而 具体 功能 则 可 由 子 菜单 进行 选择 。 

传统 的 子 菜单 一 般 采 用 树 型 的 层次 化 结构 ,但 Android 系统 却 使 用 浮动 窗 体 的 形式 
显示 菜单 子 项 。 采 用 与 众 不 同 的 显示 方式 ,主要 是 为 了 更 好 适应 小 屏幕 的 显示 方式 。 子 
菜单 不 支持 典 套 ,也 就 是 说 不 能 够 在 子 菜单 中 再 使 用 子 菜单 。 

下 面 以 SubMenu 示例 说 明 如 何 使 用 XML 文件 设计 子 菜单 。SubMenu 示例 的 用 户 
界面 如 图 5. 30 所 示 。 


SubMenu SubMenu 


图 5.30 SubMenu 示例 界面 


SubMenu 示例 选项 菜单 包含 两 个 菜单 项 :“ 设 置 "和 * 新 建 "。 菜 单项 “设置 "包含 子 
菜单 , 子 菜单 中 只 有 1 个 菜单 项 “打印 *。 菜 单项 “新建 " 包 含 子 菜单 , 子 菜单 中 有 2 438 
单项 ,分 别 是 “邮件 "和 “订阅 ”SubMenu 示例 的 菜单 结构 如 下 。 


(+) 设 置 
COTTED 
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(+) 新 建 
co 
COR 


SubMenu 示例 使 用 XML 文件 描述 菜单 结构 ,sub_menu. xml 文件 代码 如 下 。 


工 <?xml version= "1.0" encoding- "utf- 8"?» 

2 «menu xmlns:android- "http: //schemas .android.com/apk/res/android"» 

3 «item android:id- "ё +id/main menu 0" al А 
4 android:icon- "ё ігамар1е/рісо" 5 u 
5 android:title- "设置 " > 
6 <menu> m 
7 «item android:id="@ +id/sub menu 0 0" 

8 android:icon- "ё drawable/pic4" 

9 android:title- "打印 " /> 

10 < /menu» 

11 < /item> 

12 «item android:id= "@+id/main menu 1" 

13 android:icon- "6 drawable/picl" 

14 android:title- "Ў" > 

15 «menu» 

16 «item android:id- "ё + id/sub menu 1 0" 

17 android:icon- "@ drawable/pic2" 

18 android:title- "lif" /> 

19 < item android:id- "ё *id/sub menu 1 1" 

20 android:icon- "@ drawable/pic3" 

21 android:title- "Т" /> 

22 < /menu> 

23 < /item> 


24 «/menu» 


代码 第 6 行 至 代码 第 10 行 是 一 个 子 菜 单 的 描述 。 子 菜单 也 使 用 二 menu 二 标签 进行 
声明 ,内 部 使 用 二 item 二 标签 描述 菜单 项 。 

Android 系统 的 子 菜 单 使 用 起 来 非常 灵活 ,除了 可 以 XML 文件 描述 菜单 结构 ,也 可 
以 通过 代码 在 选项 菜单 或 快捷 菜单 中 使 用 子 菜单 。SubMenu2 是 使 用 代码 实现 子 菜单 的 
示例 ,界面 如 图 5. 31 所 示 。 

SubMenu2 子 菜单 结构 与 SubMenu 示例 是 完全 相同 的 ,不 同 之 处 在 于 子 菜单 上 多 了 
标题 图 标 。 下 面 首先 给 出 SubMenu2 示例 的 核心 代码 : 
final static int MENU 00=Menu.FIRST; 


final static int MENU 01=Menu.FIRST+ 1; 
final static int SUB MENU 00 01=Menu.FIRST+ 2; 


final static int SUB MENU 01 00=Menu.FIRST+ 3; 
final static int SUB MENU 01 01=Menu.FIRST+ 4; 
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SubMenu2 SubMenu2 


5.31 SubMenu2 示例 界面 


7 SubMenu sub1= (SubMenu)menu.addSubMenu (0,MENU 00,0, "iX $i") 
8 -setHeaderIcon (R.drawable.pic3); 
9 subl.add(0,SUB MENU 00 01 ,0,™ Ép") .setIcon (R.drawable.pic0); 


10 
11 SubMenu sub2- (SubMenu)menu.addSubMenu(0,MENU 01,1, "Ё ") 
12 -SetHeaderIcon (R.drawable.picl); 


13 sub2.add(0,SUB MENU 01 00 ,0," 邮 件 ") .setIcon (R. drawable.pic2); 
14 sub2.add(0,SUB MENU 01 01 ,0, "iT li] ") .setIcon (R.drawable.pic4); 


代码 第 1 行 至 第 5 行 是 定义 选项 菜单 和 子 菜单 所 有 菜单 项 的 ID。 代码 第 7 行使 用 
addSubMenu O PR Zi fe vei E rpm gp. 1 个 菜单 项 MENU _00, 当 用 户 点 击 这 个 菜单 项 
后 会 打开 子 菜单 。addSubMenu() 函 数 共 有 4 个 参数 ,参数 1 是 组 ID ,如 果 不 分 组 则 可 以 
使 用 0; 参 数 2 是 菜单 项 的 ID; 参数 3 是 显示 排序 ,数字 越 小 越 靠 近 列 表 上 方 ; 参 数 4 是 菜 
单项 显示 的 标题 。 代 码 第 8 行 设 置 了 子 菜单 的 图 标 。 代 码 第 9 行 在 子 菜单 中 添加 了 菜 
单项 。 
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快捷 菜单 类 似 于 计算 机 程序 中 的 “右键 菜单 ”, 当 用 户 点 击 界面 上 某 个 元 素 超过 2 秒 
后 ,将 启动 注册 到 该 界面 元 素 的 快捷 菜单 。 快 捷 菜 单 同样 采用 浮动 的 显示 方式 ,虽然 快 
捷 菜 单 的 现实 方式 与 子 菜单 相同 ,但 两 种 菜单 的 启动 方式 却 截然 不 同 。 
后 面 内 容 将 用 ContextMenu 示例 说 明 如 何 使 用 快捷 菜单 ,如 何 将 快捷 菜单 注册 到 某 
个 界面 元 素 上 。ContextMenu 示例 的 用 户 界面 如 图 5. 32 所 示 。 

快捷 菜单 的 使 用 方法 与 选项 菜单 极为 相似 ,只 是 重 载 的 函数 不 同 而 已 。 快 捷 菜单 需 
要 重 载 onCreateContextMenu() 函 数 初始 化 菜单 项 ,包括 添加 快捷 菜单 所 显示 的 标题 .图 
标 和 菜单 子 项 等 内 容 。 

下 面 的 代码 说 明 如 何 使 用 onCreateContextMenu O 函数 初始 化 菜单 项 。 


final static int CONTEXT МЕМО l=Menu.FIRST; 
final static int CONTEXT MENU 2=Menu.FIRST+1; 
final static int CONTEXT MENU 3=Menu.FIRST+2; 
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@override 
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快捷 菜单 标题 
菜单 子 项 1 


菜单 子 项 2 


菜单 子 项 3 


5.32 ContextMenu 用 户 界面 


5 public void onCreateContextMenu (ContextMenu menu, View v,ContextMenuInfo menuInfo)( 

6 menu.setHeaderTitle ("快捷 菜单 标题 "); operen] 
7 menu.add (0, CONTEXT MENU 1, 0," 72 1"); 
8 
9 


menu.add(0, CONTEXT MENU 2, 1," 菜 单子 项 2"); 
menu.add(0, CONTEXT МЕМО 3, 2, "菜单 子 项 3"); 


10 ) 
上 面 的 代码 实现 了 一 个 具有 3 个 菜单 项 的 子 菜单 , 子 菜单 的 标题 是 “快捷 菜单 标 
W”, ContextMenu 类 支持 add O PR ОК 7 行 ) 和 addSubMenu O Р. nf DA de Deb 
菜单 中 添加 菜单 子 项 和 子 菜单 。onCreateContextMenu() 函 数 ( 代 码 第 5 £50 978 1 个 参 
数 menu 是 需要 显示 的 快捷 菜单 ;第 2 个 参数 v 是 用 户 点 击 的 界面 元 素 ;第 3 个 参数 
menulnfo 是 所 选择 界面 元 素 的 额外 信息 。 
重 载 onContextItemSelected() 函 数 响应 菜单 选择 事件 。 该 函数 在 用 户 选 择 快捷 菜 
单 中 的 菜单 项 后 被 调用 ,与 onOptionsItemSelected() 函 数 的 使 用 方法 基本 相同 。 
下 面 代码 将 说 明 如 何 重 载 onContextItemSelected O 函数 响应 子 菜单 事件 。 


@ Override 
public boolean onContextItemSelected (MenuItem item) { 
Switch (item.getItemId()){ 
Case CONTEXT MENU 1: 
LabelView.setText ("菜单 子 项 1"); 


return true; 
Case CONTEXT MENU 2: 
LabelView.setText ("菜单 子 项 2"); 


о б - су Dpr 


return true; 
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10 case CONTEXT MENU 3: 

п LabelView.setText ("菜单 子 项 3"); 
12 return true; 

33 } 

14 return false; 

15 } 


最 后 ,还 需要 使 用 registerForContextMenu O PR „ЕЭ Pñ. TE JF 89] St n np 5 Ж АТ 
控件 上 (下 方 代码 第 7 行 )。 在 用 户 长 时 间 点 击 该 界面 控件 时 , 便 会 启动 快捷 菜单 。 同 
时 ,为 了 能 够 在 界面 上 直接 显示 用 户 所 选择 快捷 菜单 的 菜单 项 ,在 代码 中 引用 了 界面 元 
Ж TextView( 下 方 代码 第 6 行 ), 通 过 更 改 TextView 的 显示 内 容 ( 上 方 代码 第 5、8 和 
11 行 ), 显 示 用 户 所 选择 的 菜单 子 项 。 


TextView LabelView-null; 
@ Override 
public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 


setContentView (R.layout.main); 
LabelView- (TextView)findViewById (R.id.label); 
registerForContextMenu (LabelView); 

) 


下 方 代码 是 /src/layout/main. xml 文件 的 部 分 内 容 , 第 1 行 声明 了 TextView 的 ID 
为 label, 在 上 方 代 码 的 第 6 行 中 ,通过 К. id. label 将 ID 传递 给 findViewById O р. iX 
样 用 户 便 能 够 引用 该 界面 元 素 , 并 能 够 修改 该 界面 元 素 的 显示 内 容 。 


Oo - 0 0 > ш Ñ P 


<TextView android:id="@+id/label" 
android:layout_width= "fill parent" 


x 

2 

3 android:layout_height="fill parent" 
4 android:text- "ё string/hello" 

5 


/» 

还 有 一 点 需要 注意 ,上 方 代码 的 第 2 行 ,将 androidilayout. width 设置 为 fill parent. 
这 样 Text View 将 充满 父 节点 所 有 剩余 屏幕 空间 ,用 户 点 击 屏幕 TextView 下 方 任何 位 
置 都 可 以 启动 快捷 菜单 。 如 果 将 android:layout_width 设置 为 wrap_content, 则 用 户 必 
须 准 确 点 击 TextView 才能 启动 快捷 菜单 。 


55 操作 栏 与 Fragment 


551 操作 栏 


操作 栏 (Action Bar) 是 Android 3. 0 新 引入 的 界面 元 素 , 代 蔡 传 统 的 标题 栏 功能 ， 
图 5. 33 所 示 是 电子 邮件 程序 的 快捷 栏 。 操 作 栏 左 侧 的 图 标 是 应 用 程序 的 图 标 (Logo)， 
图 标 旁 边 是 应 用 程序 当前 Activity 的 标题 , 右 侧 的 多 个 图 标 则 是 选项 菜单 中 的 菜单 项 。 
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ЖӘ) Email а с 


A 


5.33 ”电子 邮件 程序 的 快捷 栏 


操作 栏 可 以 提供 多 个 实用 的 功能 .包括 : 

CD 将 选项 菜单 的 菜单 项 显示 在 操作 栏 的 右 侧 ; 

(2) 基于 Fragment 实现 类 似 于 Tab 页 的 导航 切换 功能 ; 

(3) 为 导航 提供 可 拖 忠 一 放置 的 下 拉 列 表 ; 

(4) 可 在 操作 栏 上 实现 类 似 于 搜索 框 的 功能 。 

默认 情况 下 ,所 有 高 于 Android 3.0 的 系统 中 ,基于 holographic 主题 的 Activity 上 
方 都 存在 操作 栏 。 如 果 程 序 开 发 人 员 需 要 隐藏 Activity 的 操作 栏 ,可 以 在 
AndroidManifest. xml 文件 中 添加 如 下 代码 : 


«activity android:theme="@ android:style/Theme.Holo.NoActionBar"» 
或 者 在 代码 中 加 入 : 


ActionBar actionBar- getActionBar (); 
actionBar.hide(); 


在 操作 栏 被 隐藏 后 ,Android 系统 会 自动 调整 界面 元 素 , 填 充 隐 藏 操作 栏 所 腾 出 的 
空间 。 

操作 栏 右 侧 用 来 显示 选项 菜单 的 菜单 项 ,但 所 显示 的 内 容 , 会 根据 操作 栏 所 具有 的 
空间 不 同 而 具有 不 同 的 显示 方式 。 在 屏幕 尺寸 较 小 的 设备 上 ,操作 栏 会 自动 隐藏 菜单 项 
的 文字 ,而 仅 显 示 菜 单项 的 图 标 ;而 在 屏幕 尺寸 较 大 的 设备 上 ,操作 栏 会 同时 显示 菜单 项 
的 文字 和 图 标 。 

将 选项 菜单 的 菜单 项 标识 为 可 在 操作 栏 中 显示 的 代码 非常 简单 ,只 需要 在 XML Ж 
单 资 源 文件 的 item 标签 中 添加 下 面 第 6 行 代码 即 可 。 


£ <?xml version= "1.0" encoding- "utf- 8"?> 

2 «menu xmlns:android= "http: //schemas.android.com/apk/res/android"> 
3 «item android:id="@ +id/main menu 0" 

4 android:icon- "ё drawable/pic0" 

5 android:title- "打印 " 

6 

Y 


android:showAsAction- "ifRoom|withText"/» 
< /menu» 

第 6 行 代码 中 的 ifRoom 表示 如 果 操 作 栏 有 剩余 空间 . 则 显示 该 菜单 项 的 图 标 ; 
withText 表示 显示 图 标的 同时 显示 文字 标题 。 

下 面 首先 以 ActionBar 示例 说 明 如 何在 操作 栏 上 显示 选项 菜单 。ActionBar 示例 的 
运行 界面 如 图 5. 34 所 示 ,其 中 图 5. 34(a) 是 WXGA720 (1280X720) 解 析 度 下 的 显示 效 
果 , 其 中 图 5.34(b) 是 WVGA800(480X800) 解 析 度 下 的 显示 效果 。 由 此 可 见 ,解析 度 的 
大 小 和 屏幕 的 方向 ,一 定 程 度 上 决定 了 操作 栏 的 显示 内 容 和 显示 方式 。 

ActionBar 示例 与 OpionMenu 示例 的 代码 基本 相同 ,基本 思想 都 是 使 用 XML 文件 


的 


onOptionsItemSelected O PR Zi Ab JHI 2 


资 


$4 ü 10:40 


ActionBar CEEE PE ГЕ 


(а) WXGA720 (1280X 720) 
К 4: Ë 10:40 


ActionBar ^ NE 


(b) WVGAS8O00(480 х 800) 


5.34  ActionBar 示例 用 户 界面 


,然后 在 Activity 中 通过 onCreateOptionsMenu O 函数 加 载 选 项 菜 
单 选择 事件 。 


用 


不 同 之 处 在 于 ActionBar 示例 main. menu. xml 文件 中 的 所 有 菜单 项 都 添加 了 


ifRoom 和 withText 标志 位 ,可 以 在 操作 术 


:中 显示 图 标 和 文字 标题 。 


main_menu. xml 文件 的 完整 代码 如 下 


<?xml version- "1.0" encoding- "utf- 8"?» 


«menu xmlns:android- 


http: //schemas .android.com/apk/res/android"» 
«item android:id- "ё + id/main menu 0" 

android:icon- "ё drawable/picO0" 

android:title- "打印 " 


android:showAsAction- "ifRoom|withText"/> 
«item android:id="@+ іа/таіп menu 1" 
android:icon- "ё drawable/picl" 
android:title- "Jj ff" 
android:showAsAction- "ifRoom|withText"/» 
«item android:id- "ё + id/main menu 2" 
android:icon- "ё drawable/pic2" 
android:title- "ЙЕ" 
android:showAsAction- "ifRoom|withText"/> 
«item android:id="@ +id/main menu 3" 
android:icon- "ё drawable/pic3" 


android:title- "设置 " 


android:showAsAction= "ifRoom|withText"/> 
«item android:id="@+id/main menu 4" 


android:icon- "ё drawable/pic4" 
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21 android:title= "订阅 " 

22 android:showAsAction- "ifRoom|withText"/» 

23 «/menu» 

ActionView 示例 是 在 ActionBar 示例 基础 上 做 的 修改 ,在 操作 栏 上 增加 了 文字 输入 
功能 。ActionView 示例 的 运行 界面 如 图 5. 35 所 示 , 这 是 在 WXGA720 (1280X720) 解 
析 度 下 的 显示 效果 。 


Ç 4: Ë 10:41 


ActionView E H 


图 5.35 ActionView 示例 用 户 界面 


在 菜单 项 中 添加 自 定义 显示 内 容 , 实 现 的 方法 是 在 item 标签 中 添加 android: 
actionLayout 属性 ,并 将 属性 值 定义 为 需要 显示 的 布局 文件 。ActionView 示例 在 main_ 


menu, xml 文件 中 添加 了 下 面 的 第 5 行 代码 。 


í «item android:id="@ + іа/таіп menu 0" 

2 android:icon- "ё drawable/pic0" 

3 android:title- "fJ Ep " 

4 android:showAsAction- "ifRoom|withText" 

5 android:actionLayout- "ё layout/printview" /> 


代码 第 5 行 表示 显示 该 菜单 项 时 ,采用 /layout/printview. xml 文件 作为 自 定义 
布局 。 
printview. xml 文件 的 完整 代码 如 下 。 


1 «?xml version- "1.0" encoding- "utf- 8"?> 


ю 


< LinearLayout xmlns:android= "http://schemas .апагоіа.сот/арк/геѕ/апагоіа" 


3 android:layout width= "wrap content" 

4 android:layout height="wrap content" 

5 android:orientation="horizontal" > 

6 

$ < InageView 

8 android:layout width= "wrap content" 
9 android:layout height- "wrap content" 
10 android:src- "ё drawable/picO" /> 

12. 

12 «EditText 

13 android:layout width- "wrap content" 
14 android:layout height- "wrap content" 
15 android:hint- "输入 需要 打印 的 文件 名 称 " 
16 android:ems= "12" /> 
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17 


18 </LinearLayout> 


552 Fragment 


Fragment 是 Android 3. 0 新 引入 的 概念 ,主要 目的 在 大 屏幕 设备 上 实现 灵活 ,动态 
的 界面 设计 。 例 如 ,在 Android 的 平板 电脑 上 ,因为 屏幕 有 更 多 的 空间 来 放置 更 多 的 界 
面 组 件 ,并 且 这 些 组 件 之 间 还 会 产生 一 定 的 数据 交互 。 

Fragment 支持 这 种 设计 理念 ,开发 人 员 不 须 管理 复杂 的 视图 结构 变化 ,而 把 这 些 动 
态 的 管理 工作 交 给 Fragment 和 回 退 堆栈 (back stack) 完 成 。 在 进行 界面 设计 时 ,只 需要 
将 界面 布局 按照 功能 和 区 域 划 分 为 不 同 的 模块 ,每 个 模块 设计 成 一 个 Fragment 即 可 。 

例如 ,在 新 闻 阅 读 程序 中 ,可 以 将 界面 划分 为 左右 两 部 分 ,并 分 别 使 用 Fragment 实 
现 。 左 侧 用 来 展示 新 闻 列 表 , 右 侧 用 来 阅读 新 闻 的 具体 内 容 。 两 个 Fragment 可 以 并 排 
地 放置 在 同一 个 Activity 中 , 且 这 两 个 Fragment 都 具有 自己 的 生命 周期 回调 函数 和 界 
面 输入 事件 。 如 果 不 使 用 Fragment, 开 发 人 员 就 需要 在 一 个 Activity 中 实现 展示 新 闻 列 
表 , 而 在 另 一 个 Activity 中 显示 新 闻 的 具体 内 容 。 使 用 Fragment 就 可 以 将 两 部 分 功能 
合并 到 同一 个 Activity 中 实现 ,如 图 5. 36 所 示 。 


平板 电脑 智能 手机 
在 同一 个 Activity 中 的 两 个 Activity 中 的 
两 个 不 同 的 Fragment 两 个 Fragment 


p ————————4 


5.36 Fragment 示意 图 


Fragment 是 可 以 被 设计 成 为 可 重用 模块 的 ,这 是 因为 每 个 Fragment 都 有 自己 的 布 
局 和 生命 周期 回调 函数 ,可 以 将 同一 个 Fragment 放置 到 多 个 不 同 的 Activity 中 。 这 样 ， 
在 设计 时 为 了 可 重用 Fragment, 开 发 人 员 应 该 避免 直接 从 一 个 Fragment 去 操纵 另 一 个 
Fragment, 这 样 就 增加 了 两 个 Fragment 之 间 的 耦合 度 ,不 利于 模块 的 重用 。 

Fragment 的 另 一 个 重要 特性 就 是 通过 不 同 的 Fragment 组 合 ,可 以 适应 不 同 尺寸 的 
屏幕 。 以 前 面 介 绍 的 新 闻 阅 读 程 序 为 例 , 如 果 需 要 同时 支持 平板 电脑 和 智能 手机 , 则 可 
以 重用 为 平板 电脑 设计 的 两 个 Fragment, 在 智能 手机 端 将 两 个 Fragment 加 载 到 两 个 
Activity 中 。 
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Fragment 具有 与 Activity 类 似 的 生命 周期 ,但 比 Activity 支持 更 多 的 事件 回调 函 
数 。Fragment 生命 周期 中 的 事件 回调 函数 ,以 及 之 间 的 调用 顺序 可 参考 图 5. 37。 


onAttach() onCreate() onCreateView() 
Fra ШЕ 
销毁 
Fragment| | onDetach() onDistroy View() 


图 5.37 Fragment 生命 周期 中 的 事件 回调 函数 


onActivityCreated() 
onStart() 


Fragment 


处 于 活动 
状态 


onStop() onPause() 


onDestroy View() 


通常 情况 下 ,创建 Fragment a 需要 继承 Fragment 的 基 类 ,并 至 少 应 实现 onCreateO , 
onCreateView() 和 onPause() 三 个 生命 周期 的 回调 函数 。 当 然 , 如 果 仅 通过 Fragment W 
示 元 素 ,而 不 进行 任何 的 数据 保 存 和 界面 事件 处 理 , 则 仅 实 现 onCreateView() 函 数 也 可 
创建 Fragment。 

onCreate() 函 数 是 在 Fragment 创建 时 被 调用 ,用 来 初始 化 Fragment 中 的 必要 组 
件 。onCreateView() PR Ж J& Fragment 在 用 户 界 面 上 第 一 次 绘制 时 被 调用 ,并 返回 
Fragment 的 根 布 局 视图 。onPause() 函数 是 在 用 户 离开 Fragment 时 被 调用 ,用 来 保存 
Fragment 中 用 户 输入 或 修改 的 内 容 。 

F ifii fH FragmentDemo 示例 说 明 如 u 在 一 个 Activity 中 同时 加 载 两 个 Fragment, 
FragmentDemo 示例 的 用 户 界面 如 图 5. 38 所 示 。FragmentDemo 示例 以 屏幕 的 中 心 线 
为 界 , 在 一 个 Activity 中 并 列 加 载 了 两 个 Fragment, £ Mj i AFragment, 右 侧 是 
BFragment。 


Ç 1. 0 10:43 


FragmentDemo 


AF 选 项 


AF 技 钮 


图 5.38 FragmentDemo 示例 的 用 户 界 面 


图 5. 39 是 FragmentDemo 示例 的 文件 结构 。 在 这 个 示例 中 ,每 个 Fragment 使 用 一 
个 Java 文件 实现 ,并 加 载 各 自 的 布局 文件 ,例如 在 AFragment. java 文件 中 实现 
AFragment ,并 加 载 布 局 文件 frag. a. xml, 

main. xml 文件 是 FragmentDemo 示例 中 唯一 的 Activity 的 布局 文件 ,两 个 
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4 1.5 FragmentDemo| 
4 @ src 
4 8 eduhrbeu.FragmentDemo 
> [Й AFragmentjava 
> [Й BFragmentjava 
> [Й FragmentDemoActivityjava 
b @Э gen [Generated Java Files] 
b mÀ Android 4.0 
assets 
b B bin 
@ res 
> © drawable-hdpi 
> @ drawable-ldpi 
> © drawable-mdpi 
4 (& layout 
国 frag_axml 
国 frag_b.xml 
国 mainxml 
b © values 
回 AndroidManifest.xml 
[8] proguard.cfg 
В project.properties 


图 5.39  FragmentDemo 示例 的 文件 结构 
Fragment 在 界面 上 的 位 置 关 系 就 在 这 个 文件 中 进行 定义 。 下 面 给 出 main. xml 文件 的 
完整 代码 如 下 。 


1  «LinearLayout xmlns:android= "http://schemas.android.com/apk/res/android" 


2 android:orientation="horizontal" 


3 android:layout_width= "match parent" 

4 android:layout_height= "match parent"> 

5 

6 < fragment android:name- "edu.hrbeu.FragmentDemo.AFragment" 
7 android:id="@ + id/fragment a" 

8 android:layout_weight="1" 

9 android:layout_width= "0px" 

10 android:layout height- "match parent" /> 

41 

12 < fragment android:name= "edu.hrbeu.FragmentDemo.BFragment" 
ЯЗ android:id- "ё +id/fragment b" 

14 android:layout weight- "1" 

15 android:layout width- "Opx" 

16 android:layout height- "match parent" /» 

17 


18 «/LinearLayout» 


代码 第 6 行使 用 标签 fragment 声明 了 一 个 Fragment. TE name 属性 中 用 “ 包 十 类 ”的 
方式 定义 了 AFragment 所 在 的 类 。 代 码 第 12 行 定义 了 BFragment。 代 码 第 8 行 和 第 
14 行 表 明 两 个 Fragment 在 界面 上 的 布局 权重 是 相同 的 ,因此 应 在 界面 上 各 占 50% 的 界 
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面 空间 。 
FragmentDemoActivity 是 该 示例 主 界 面 的 Activity, 加 载 了 main. xml 文件 声明 的 
界面 布局 。FragmentDemoActivity. java 文件 的 完整 代码 如 下 。 


1 public class FragmentDemoActivity extends Activity { 


N 


@ Override 


public void onCreate (Bundle savedInstanceState) { 


3 

4 super.onCreate (savedInstanceState); 
5 setContentView (R.layout.main); 
6 

7 


) 


Android 系统 会 根据 代码 第 5 行 的 内 容 加 载 界 面 布局 文件 main. xml, 然 后 通过 
main. xml 文件 中 对 Fragment 所 在 的 “ 包 十 类 ”的 描述 ,找到 Fragment 的 实现 类 ,并 调用 
类 中 的 onCreateView() 函 数 绘制 界面 元 素 。 

AFragment. java 文件 的 核心 代码 如 下 。 


1 public class AFragment extends Fragment { 


2 @override 

3 public View onCreateView (LayoutInflater inflater, ViewGroup 
container, Bundle savedInstanceState)( 

4 return inflater.inflate (R.layout.frag a, container, false); 

5 } 

6 

T U 


AFragment 中 只 实现 了 onCreateView O PR Zt ORE 3 ff). R [nl fli R: AFragment 
的 视图 。 代 码 第 4 行使 用 inflate() 函 数 ,通过 指定 资源 文件 R. layout. frag. a. Ж E 
AFragment 的 视图 。 

最 后 给 出 frag_a. xml 文件 的 全 部 代码 如 下 。 


<?xml version- "1.0" encoding- "utf- 8"?» 

2  «LinearLayout xmlns:android- "http: //schemas .android.com/apk/res/android" 
3 android:layout width- "wrap content" 

4 android:layout height- "wrap content" 

5 android:orientation- "vertical" » 

6 

y <TextView 

8 android:layout width- "wrap content" 
9 android:layout height- "wrap content" 
10 android:text- "AFragment" /> 

11 

12 < TextView 

13 android:layout width="wrap content" 


14 android:layout _ height= "wrap content" 
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15 android:text=" 这 是 AFragment 的 显示 区 域 , 通 过 这 行文 字 可 以 看 到 与 BEragment 
的 边界 " /> 


16 

17 <CheckBox 

18 android:layout width= "wrap content" 
19 android:layout _ height= "wrap content" 
20 android:text- "АЕ 选项 " /> 

21 

22 <Button 

23 android:layout width= "wrap content" 
24 android:layout height= "wrap content" 
25 android:text- "AF 按钮 " /> 

26 


27 </LinearLayout> 
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在 界面 控件 的 章节 中 介绍 过 使 用 TabHost 和 TabActivity 实现 Tab 导航 栏 的 功能 ， 
但 因为 TabActivity 已 经 过 期 ,所 以 这 里 介绍 一 种 新 方法 ,使 用 操作 栏 和 Fragment 实现 
Tab 导航 栏 。 

下 面 用 FragmentTab 示例 说 明 如 何 使 用 操作 栏 和 Fragment 实现 Tab 导航 栏 ， 
FragmentTab 示例 的 用 户 界面 如 图 5. 40 所 示 。 


Ça: G 10:45 АДЛ, 10:46 


FRAGMENT A FRAGMENT B FRAGMENT A FRAGMENT B 


: 
Jr 


图 ) AF 选 项 


BF 按钮 


图 5.40 FragmentTab 示例 的 用 户 界 面 


第 一 个 Tab 页 的 标题 为 “FRAGMENT A”, 第 二 个 Tab 页 的 标题 为 “FRAGMENT 
B”, 两 个 Tab 页 分 别 加 载 了 不 同 Fragment, 两 个 Fragment 所 显示 的 界面 元 素 略 有 不 同 。 
从 图 5. 41 的 文件 结构 可 以 看 得 出 来 ,FragmentTab 示例 和 FragmentDemo 示例 中 的 一 
部 分 文件 的 文件 名 称 是 完全 相同 的 ,这 些 文件 中 的 代码 也 是 完全 相同 的 。 这 些 文件 包括 
AFragment. java, BFragment. java frag_a. xml 和 frag b. xml。 这 里 就 不 再 给 出 上 述 文 
件 的 源 代 码 ,读者 可 以 参考 FragmentDemo 示例 。 
建立 Tab 导航 栏 ,以 及 将 导航 栏 和 Fragment 关联 起 来 的 代码 都 在 FragmentTabActivity 
.java 文 件 中 。 下 面 分 别 介 绍 FragmentTabActivity. java 文件 中 的 核心 函数 。 

先 给 出 onCreate() 函数 的 代码 。 
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H Package Explorer 22% ъъ» еп 
5 FragmentTab 
@ src 
8 edu.hrbeu.FragmentTab 
D AFragmentjava 
国 BFragmentjava 
国 FragmentTabActivity java 
@8 gen [Generated Java Files] 
тюй Android 4.0 
色 assets 
Ф bin 
$ res 
© drawable-hdpi 
© drawable-ldpi 
© drawable-mdpi 
layout 
R) frag. axxml 
因 бад Ьхті 
@ values 
Id] AndroidManifestxml 
[8] proguard.cfg 
B project.properties 


5.41 FragmentTab 示例 的 文件 结构 


1 @Оуеггїде 

2 public void onCreate (Bundle savedInstanceState)( 

3 super.onCreate (savedInstanceState); 

4 

5 final ActionBar bar-getActionBar (); 

6 bar.setNavigationMode (ActionBar.NAVIGATION MODE TABS); 

+ bar.setDisplayOptions (0, ActionBar.DISPLAY SHOW TITLE); 

8 

9 bar.addTab (bar .newTab () 

10 .SetText ("Fragment A") 

11 .SetTabListener (new TabListener< AFragment> (this, "fa",AFragment. 
class))); 

12 bar.addTab (bar .newTab () 

13 .SetText ("Fragment В") 

14 .SetTabListener (new TabListener« BFragment> (this, "fb", BFragment. 
class))); 

15 

16 if (savedInstanceState!= null) { 

17 bar.setSelectedNavigationItem(savedInstanceState.getInt ("tab", 0)); 

18 } 

35 } 


代码 第 5 行 调用 getActionBar() 获 取 操 作 栏 实例 。 

代码 第 6 行将 操作 栏 的 导航 模式 设置 为 Tab 导航 栏 模式 ,NAVIGATION_MODE _ 
TABS 常量 的 值 为 2。 还 支持 的 常量 包括 NAVIGATION. MODE LIST Cf Jy 1) 和 
NAVIGATION MODE STANDARD( 值 为 0) ,分 别 表示 列表 导航 栏 和 标准 导航 栏 。 
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代码 第 7 行 用 来 设置 操作 栏 的 显示 选项 。setDisplayOptions(int options, int mask) 
函数 表示 在 options 与 mask 取 反 。 第 7 行 代码 的 意思 是 关闭 "显示 标题 文字 (DISPLAY 
_SHOW_TITLE)”, setDisplayOptions O 函数 支持 的 常量 如 表 5. 4 所 示 。 


Ж 5.4 setDisplayOptions() 函 数 支 持 的 常量 


常 量 值 说 — HH 
DISPLAY HOME AS UP 4 在 Home 元 素 左 侧 显示 回 退 按钮 
DISPLAY SHOW CUSTOM 16 显示 自 定义 视图 
DISPLAY SHOW HOME 2 在 操作 栏 中 显示 Home 元 素 
DISPLAY_SHOW_TITLE 8 显示 Activity 的 标题 
DISPLAY_USE_LOGO 1 使 用 Logo 代替 程序 图 标 


代码 第 9 行使 用 add O 函数 添 加 Tab 页 ,代码 第 10 行 设置 Tab 页 的 标题 ,代码 第 
11 行 定义 Tab 页 点 击 事件 的 监听 函数 。 

代码 第 16 行 和 第 17 行 ,表明 如 果 Activity 不 是 首次 启动 , 则 在 savedInstanceState 
变量 中 获取 当前 Tab 页 的 索引 号 。 

onSavelInstanceState() PAXE Activity 临时 退出 时 ,将 当前 Tab 页 的 索引 号 保存 在 


Bundle 中 ,代码 如 下 。 


1 @Override 

2 protected void onSaveInstanceState (Bundle outState)( 

3 super.onSaveInstanceState (outState); 

4 outState.putInt ("tab", getActionBar ().getSelectedNavigationIndex|()); 
5 } 


构造 Tab 导航 栏 的 事件 监听 函数 ,必须 实现 ActionBar. TabListener 接口 ,主要 是 实现 
接口 中 的 3 个 函数 ,分 别 是 onTabSelected ()、onTabUnselected () 和 onTabReselected ()。 
onTabSelected O fE M fij Tab 页 被 选中 时 调用 ,onTabUnselected() 在 其 他 Tab 页 被 选中 
时 调用 ,onTabReselected() 在 当前 Tab 页 被 再 次 选中 时 调用 。 

静态 类 TabListener 的 代码 如 下 。 


1 public static class TabListener < T extends Fragment > implements ActionBar. 
TabListener ( 
private final Activity mActivity; 
private final String mTag; 
private final Class< T>mC1ass; 
private final Bundle mArgs; 


private Fragment mFragment; 


oO а o Q м 
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public TabListener (Activity activity, String tag, Class« T» clz)( 


5 this(activity, tag, clz, null); 

10 } 

M. 

12 public TabListener (Activity activity, String tag, Class< T> clz, Bundle 
args) ( 

13 mActivity=activity; 

14 mTag= tag; 

15 mClass=clz; 

16 mArgs=args; 

37 

18 mFragment-mActivity.getFragmentManager () . findFragmentByTag (mIag) ; 

19 if (mFragment !=null && !mFragment.isDetached|()) (FragmentTransaction 

20 ft=mActivity.getFragmentManager () .beginTransaction (); 

2t ft.detach (mFragment) ; 

22 ft.commit () ; 

23 } 

24 I 

25 

26 public void onTabSelected (Tab tab, FragmentTransaction ft)( 

27 if (mFragment- -null)( 

28 mEragrent=Fragment .instantiate (mctivity, mClass.getName(), mArgs); 

29 ft.add(android.R.id.content, mFragment, mTag); 

30 } eise ( 

31 ft.attach (mFragment) ; 

32 } 

33 } 

34 

35 public void onTabUnselected (Тар tab, FragmentTransaction ft) { 

36 if (mrragment !=nu11) { 

37 ft .detach (mFragment) ; 

38 } 

39 } 

40 

41 public void onTabReselected (Tab tab, FragmentTransaction ft) { 

42 Toast .makeText (mActivity, "Reselected!", Toast .LENGTH SHORT) .show(); 

43 ] 

44 } 


FragmentTransaction 是 封装 了 Fragment 变换 所 要 用 的 函数 ,包括 将 Fragment 加 入 到 
Activity 的 addO 〇 函数 ,将 Fragment 从 当前 界面 分 离 的 Detach() 函 数 ,将 被 Detach O PR 2 ZF 
离 的 Fragment 重新 连接 到 界面 的 attach O PR, 

上 面 的 代码 具有 一 定 的 难度 ,部 分 内 容 涉 及 Java 泛 型 编程 的 内 容 , 例 如 代码 第 1 行 
和 第 12 行 , 读 者 可 以 参考 Java 语言 的 相关 资料 。 
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56 R E € v 


在 Android 系统 中 ,存在 多 种 界面 事件 ,如 点 击 事件 .触摸 事件 、 焦 点 事件 和 菜单 事 
件 等 ,在 这 些 事 件 发 生 时 , Android 界面 框架 调用 界面 控件 的 事件 处 理 函 数 对 事件 进行 
处 理 。 


56.1 按键 事件 


在 MVC 模型 中 ,控制 器 根据 界面 事件 (UI Event) 类 型 不 同 ,将 事件 传递 给 界面 控件 
不 同 的 事件 处 理 函 数 。 例 如 ,按键 事件 (KeyEvent) 将 传递 给 onKey O PR ICE TT Ab IE , fih 
摸 事件 (TouchEvent) 将 传递 给 on Touch O PR Zi JE 45 1b TE , 

Android 系统 界面 事件 的 传递 和 处 理 遵循 一 定 的 规则 。 首 先 , 如 果 界 面 控件 设置 了 
事件 监听 器 , 则 事件 将 先 传递 给 事件 监听 器 ;相反 ,如 果 界 面 控件 没有 设置 事件 监听 器 ， 
界面 事件 则 会 直接 传递 给 界面 控件 的 其 他 事件 处 理 函 数 。 即 使 界面 控件 设置 了 事件 监 
听 器 ,界面 事件 也 可 以 再 次 传递 给 其 他 事件 处 理 函 数 ,是 否 继续 传递 事件 给 其 他 处 理 函 
数 是 由 事件 监听 器 处 理 函 数 的 返回 值 决定 的 。 如 果 监 听 器 处 理 函 数 的 返回 值 为 true, 表 
示 该 事件 已 经 完成 处 理 过 程 ,不 需要 其 他 处 理 函 数 参 与 处 理 过 程 ,这 样 事件 就 不 会 再 继 
续 进 行 传递 。 反 之 ,如 果 监 听 器 处 理 函 数 的 返回 值 为 false, 则 表示 该 事件 没有 完成 处 理 
过 程 ,或 需要 其 他 处 理 函 数 捕获 到 该 事件 ,事件 会 传递 给 其 他 的 事件 处 理 函 数 。 

以 EditText 控件 中 的 按键 事件 为 例 , 说 明 Android 系统 界面 事件 传递 和 处 理 过 程 ， 
假设 EditText 控件 已 经 设置 了 按键 事件 监听 器 。 当 用 户 按 下 键盘 上 的 某 个 按键 时 ,控制 
KHT Æ KeyEvent 按键 事件 。Android 系统 会 首先 判断 Edit Text 控件 是 否 设置 了 按键 
事件 监听 器 ,因为 EditText 控件 已 经 设置 按键 事件 监听 器 OnKeyListener, 所 以 按键 事 
件 先 传递 到 监听 器 的 事件 处 理 函 数 onKey() 中 。 事 件 能 和 否 够 继续 传递 给 EditText 控件 
的 其 他 事件 处 理 函 数 ,完全 根据 onKey() 函 数 的 返回 值 来 确定 。 如 果 onKey() 函 数 返 回 
false, 事 件 将 继续 传递 ,这 样 Edit Text 控件 就 可 以 捕获 到 该 事件 ,将 按键 的 内 容 显示 在 
EditText 控件 中 。 如 果 onKey O PR UA E] true, 将 阻止 按键 事件 的 继续 传递 ,这 样 
EditText 控件 就 不 能 够 捕获 按键 事件 ,也 就 不 能 够 将 按键 内 容 显 示 在 EditText 控件 中 。 

Android 界面 框架 支持 对 按键 事件 的 监听 ,并 能 够 将 按键 事件 的 详细 信息 传递 给 处 
理 函 数 。 为 了 处 理 控 件 的 按键 事件 , 先 需 要 设置 按键 事件 的 监听 器 ,并 重 载 onKey O FR 
数 。 示 例 代码 如 下 。 


entryText.setOnKeyListener (new OnKeyListener () ( 
@override 
public boolean onKey (View view, int keyCode, KeyEvent keyEvent) ( 
// 过 程 代 码 …… 


1 
2 
3 
4 
5 return true; //or false; 
6 


138 Pharoia 应 用 程序 开发 (第 3 版 ) 


第 1 行 代码 是 设置 控件 的 按键 事件 监听 器 。 在 代码 第 3 行 的 onKey() 函 数 中 ,第 
1 个 参数 view 表示 产生 按键 事件 的 界面 控件 ;第 2 个 参数 keyCode 表示 按键 代码 ;第 3 
个 参数 keyEvent 则 包含 了 事件 的 详细 信息 ,如 按键 的 重复 次 数 、 硬 件 编码 和 按键 标志 
等 。 第 5 行 是 onKey() 函 数 的 返回 值 , 返 回 true, 阻 止 事件 传递 ;返回 false, 人 允许 继续 传 
递 按键 事件 。 

KeyEventDemo 是 一 个 说 明 如 何 处 理 按 键 事件 的 示例 。 在 这 个 示例 中 ,用 户 界面 如 
图 5. 42 所 示 。 


Ç PIE 
KeyEventDemo 


a 


O 返回 true， 阻 止 将 按键 事件 传递 给 界面 元 素 


图 5. 42 KeyEventDemo 界面 


在 KeyEventDemo 的 用 户 界 面 中 ,最 上 方 的 EditText 控件 是 输入 字符 的 区 域 , 中 间 
的 CheckBox 控件 用 来 控制 onKey() 函 数 的 返回 值 ,最 下 方 的 TextView 控件 用 来 显示 
按键 事件 的 详细 信息 ,包括 按键 动作 ,按键 代码 ,按键 字符 .Unicode 编码 .重复 次 数 、 功 能 
键 状态 硬件 编码 和 按键 标志 。 
界面 的 XML 文件 的 代码 如 下 。 
«EditText android:id="@ +id/entry" 
android:layout width= "fill parent" 


android:layout height- "wrap content"> 


< /EditText^ 


1 
3 
4 
5 < CheckBox android:id- "@ + id/block" 
6 android:layout width- "wrap content" 

y android:layout height- "wrap content" 

8 android:text- "返回 true, 阻 止 将 按键 事件 传递 给 界面 元 素 " > 
9 </СһескВох> 


10 <TextView android:id="@+id/label" 


11 android:layout width- "wrap content" 
12 android:layout height- "wrap content" 
13 android:text- "按键 事件 信息 "> 


14 «/TextView» 
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在 EditText 中 ,每 当 键盘 任何 一 个 键 按 下 或 抬 起 时 都 会 引发 按键 事件 。 但 为 了 能 够 
使 EditText 处 理 按键 事件 ,需要 使 用 setOnKeyListener() 函 数 在 代码 中 设置 按键 事件 监 
听 器 ,并 在 onKey() 函 数 添加 按键 事件 的 处 理 过 程 。 


1 entryText.setOnKeyListener (new OnKeyListener () { 

2 @ Override 

3 public boolean onKey (View view, int keyCode, KeyEvent keyEvent) { 

4 int metaState- keyEvent .getMetaState () ; 

5 int unicodeChar- keyEvent.getUnicodeChar () ; 

6 String msg-""; 

7 msg+ = "按键 动作 :"+ String.valueOf (keyEvent .getAction () ) + "Nn"; 

8 msg+= "按键 代码 :"+ String.valueof (keyCode) + "Nn"; 

9 msg+ = "按键 字符 :" (char) unicodeChar* "Nn"; 

10 msg+= "UNICODE: "+ String.valueOf (unicodeChar)- "An"; 

11 msg = "重复 次 数 :"+ String.valueOf (keyEvent .getRepeatCount () ) + "Nn"; 
12 msg: = "功能 键 状态 :"+ String.valueOf (metaState)* "Nn"; 

13 msg+= "硬件 编码 :"+ String.valueof (keyEvent .getScanCode () ) + "Nn"; 
14 msg+= "按键 标志 :"+ String.valueOf (keyEvent .getFlags () ) + "Nn"; 

15 labelView.setText (msg) ; 

16 if (checkBox.isChecked|()) 

37 return true; 

18 else 

19 return false; 

20 ) 


第 4 行 代码 用 来 获取 功能 键 状 态 。 功 能 键 包 括 左 Alt 键 , 右 Alc BERI Shift 键 , 当 这 
三 个 功能 键 被 按 下 时 ,功能 键 代码 metaState 值 分 别 为 18、34 和 65; 但 没有 功能 键 被 按 下 
时 ,功能 键 代码 metaState 值 都 为 0。 第 5 行 代码 获取 了 按键 的 Unicode 值 ,在 第 9 行 中 ， 
将 Unicode 转换 为 字符 ,显示 在 TextView 中 。 第 7 行 代码 获取 了 按键 动作 ,0 表示 按 下 
按键 ,1 表示 抬 起 按键 。 第 7 行 代码 获取 按键 的 重复 次 数 ,但 按键 被 长 时 间 按 下 时 , 则 会 
产生 这 个 属性 值 。 第 13 行 代码 获取 了 按键 的 硬件 编码 .不同 硬件 设备 的 按键 硬件 编码 
都 不 相同 ,因此 该 值 一 般 用 于 调试 。 第 14 行 获 取 了 按键 事件 的 标志 符 。 


562 触摸 事件 


伴随 着 触摸 屏 的 普及 ,手机 的 操作 方式 也 随 之 改变 ,用 户 已 经 不 满足 键盘 的 操作 方 
式 , 而 是 更 加 倾心 于 使 用 手指 在 屏幕 上 进行 操作 。 

Android 界面 框架 支持 对 触摸 事件 的 监听 ,并 能 够 将 触摸 事件 的 详细 信息 传递 给 处 理 
函数 。 为 了 处 理 控件 的 触摸 事件 ,首先 需要 设置 触摸 事件 的 监听 器 ,并 重 载 on Touch O PR 
数 ,示例 代码 如 下 。 


x touchView.setOnTouchListener (new View.OnTouchListener () { 


z @ Override 
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public boolean onTouch (View v, MotionEvent event) { 


// 过 程 代 码 …… 


3 
4 
5 return true/false; 
6 } 


第 1 行 代 码 是 设置 控件 的 触摸 事件 监听 器 。 在 代码 第 3 行 的 onTouch() 函 数 中 ,第 
1 个 参数 View 表示 产生 触摸 事件 的 界面 控件 ;第 2 个 参数 MontionEvent 是 触摸 事件 的 
详细 信息 ,如 产生 时 间 、 坐 标 和 触 点 压力 等 。 第 5 行 是 onTouch() 函 数 的 返回 值 。 

TouchEventDemo 是 一 个 说 明 如 何 处 理 触 摸 事 件 的 示例 。 在 这 个 示例 中 ,用 户 界 面 
如 图 5. 43 所 示 。 


TouchEventDemo 


触 拒 事件 测试 区 域 


5.43 TouchEventDemo 界面 


在 TouchEventDemo 的 用 户 界面 中 ,上 方 浅 色 区 域 是 可 以 接收 触摸 事件 的 区 域 ,用 
户 可 以 在 Android 模拟 器 中 使 用 鼠标 点 击 屏 幕 ,用 以 模拟 触摸 手机 屏幕 。 下 方 黑 色 区 域 
是 显示 区 域 ,用 来 显示 触摸 事件 的 类 型 .相对 坐标 、 绝 对 坐标 、 触 点 压力 、 触 点 尺寸 和 历史 
数据 量 等 信息 。 

在 用 户 界面 中 使 用 了 线性 布局 ,并 加 入 了 三 个 TextView 控件 ,第 一 个 TextView(ID 
为 touch_area) 用 来 标识 触摸 事件 的 测试 区 域 ,第 二 个 TextView (Тр 为 history_label) 用 
来 显示 触摸 事件 的 历史 数据 量 , 第 三 个 TextView(ID 为 event_label) 用 来 显示 触摸 事件 
的 详细 信息 ,包括 类 型 .相对 坐标 、 绝 对 坐标 、 触 点 压力 和 触 点 尺寸 。XML 文件 的 代码 
如 下 。 


2 <?xml version= "1.0" encoding- "utf- 8"? > 
2  «LinearLayout xmlns:android= "http: //schemas.android.com/apk/res/android" 
3 


android:orientation="vertical" 
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4 android:layout width= "fill parent" 

5 android:layout height="fill parent"> 

6 «TextView android:id="@ + id/touch area" 
7 android:layout width="fill parent" 

8 android:layout height- "300dip" 

9 android:background- "480A0FF" 

10 android:textColor- "RFFFFFF" 

11 android:text= "触摸 事件 测试 区 域 "> 

12 < /TextView» 

13 < TextView android:id- "Q- id/history label" 
14 android:layout width- "wrap content" 
15 android:layout height- "wrap content" 
16 android:text- "历史 数据 量 :" > 

17 < /TextView» 

18 < TextView апагоіа:ід= "ё + id/event label" 
19 android:layout міасћ= "игар content" 
2 android:layout height= "wrap content" 
21 android:text- "触摸 事件 :" > 

22 < /TextView> 


23 </LinearLayout> 


上 面 的 代码 中 ,第 9 行 定 义 了 TextView 的 背景 颜色 , # 80AOFF 是 颜色 代码 。 第 
10 行 定义 了 TextView 的 字体 颜色 。 
在 代码 中 为 了 能 够 引用 XML 文件 中 声明 的 界面 元 素 , 使 用 了 下 面 的 代码 。 


TextView labelView=null; 

labelView= (TextView)findViewById(R.id.event label); 

TextView touchView= (TextView)findViewById(R.id.touch area); 
final TextView historyView= (TextView)findViewById(R.id.history_ 
label); 


当 手 指 接触 到 触摸 屏 、 在 触摸 屏 上 移动 或 离开 触摸 屏 时 ,分 别 会 引发 ACTION 
DOWN,ACTION UP 和 ACTION MOVE 触摸 事件 ,而 无 论 是 哪 种 触摸 事件 ,都 会 调 
用 onTouch() 函 数 进行 处 理 。 事 件 类 型 包含 在 onTouch() 函 数 的 MotionEvent 参数 中 ， 
可 以 通过 getAction() 函 数 获取 到 触摸 事件 的 类 型 ,然后 根据 触摸 事件 的 不 同类 型 进行 
不 同 的 处 理 。 但 为 了 能 够 使 屏幕 最 上 方 的 TextView 处 理 触 摸 事件 ,需要 使 用 
setOnTouchListener O 函数 在 代码 中 设置 触摸 事件 监听 器 ,并 在 onTouch() 函 数 添 加 触 
摸 事 件 的 处 理 过 程 。 


щш N P 


touchView.setOnTouchListener (new View.OnTouchListener () { 


@ Override 


Я, 

3 public boolean onTouch (View v, MotionEvent event) { 
4 int action=event.getAction () ; 

5 


switch (action) { 
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6 case (MotionEvent.ACTION DOWN): 

YT Display("ACTION DOWN",event); 

8 break; 

9 case (MotionEvent.ACTION UP): 

10 int historySize- ProcessHistory (event); 
11 historyView.setText (" 历 史 数据 量 :"+historySize); 
12 Display ("ACTION UP",event); 

13 break; 

14 case (MotionEvent .ACTION MOVE): 

15 Display ("ACTION MOVE",event); 

16 break; 

17 } 

18 return true; 

19 ) 

20 n; 


第 7 行 代码 的 DisplayO 〇 是 一 个 自 定义 函数 ,主要 用 来 显示 触摸 事件 的 详细 信息 , РА 
数 的 代码 和 含义 将 在 后 面 进行 介绍 。 第 10 行 代码 的 ProcessHistory() 也 是 一 个 自 定义 
函数 ,用 来 处 理 触摸 事件 的 历史 数据 ,也 是 在 后 面 进行 介绍 。 第 11 行 代 码 是 使 用 
TextView 显示 历史 数据 的 数量 。 

MotionEvent 参数 中 不 仅 有 触摸 事件 的 类 型 信息 ,还 有 触 点 的 坐标 信息 ,获取 方法 是 
使 用 getX() 和 getY() 函 数 ,这 两 个 函数 获取 的 是 触 点 相对 于 父 界 面 元 素 的 坐标 信息 。 
如 果 需 要 获取 绝对 坐标 信息 , 则 可 使 用 getRawX О FI getRawY() 函 数 。 触 点 压力 是 一 个 
介 于 0 和 1 之 间 的 浮 点 数 ,用 来 表示 用 户 对 触摸 屏 施加 压力 的 大 小 ,接近 0 表示 压力 较 
小 ,接近 1 表示 压力 较 大 ,获取 触摸 事件 触 点 压力 的 方式 是 调用 getPressure() 函数 。 触 
点 尺寸 指 用 户 接 触 触摸 屏 的 接触 点 大 小 ,也 是 一 个 介 于 0 和 1 之 间 的 浮 点 数 ,接近 0 表示 
尺寸 较 小 ,接近 1 表示 尺寸 较 大 ,可 以 使 用 getSize() 函 数 获 取 。 

Display() 将 MotionEvent 参数 中 的 事件 信息 提取 出 来 ,并 显示 在 用 户 界 面 上 。 


private void Display (String eventType, MotionEvent event) { 
int x- (int)event.getX(); 


int у= (int)event.getY(); 


float pressure- event.getPressure(); 


1 

2 

3 

4 

5 float size-event.getSize(); 
6 int RawX- (int)event.getRawX(); 

7 int RawY- (int)event.getRawY(); 

8 

9 String msg-""; 

10 msg+ = "事件 类 型 :"+ event Type "Nn"; 

11 msg+= "相对 坐标 :"+ String.valueof (х) + ", "+ String.valueOf (у) + "Nn"; 
32 msg+= "J 4 BR :"+ String.valueOf (RawX) +", "+ String.valueOf (RawY) + "Nn"; 
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13 msg+=" 触 点 压力 :"+ String.valueOf (pressure)+","; 
14 msg+=" 触 点 尺寸 :"+String.valueof (size)+ "Nn"; 

15 labelView.setText (msg); 

16 


一 般 情况 下 ,如 果 用 户 将 手指 放 在 触摸 屏 上 ,但 不 移动 ,然后 抬 起 手指 ,应 先后 产生 
ACTION_DOWN 和 ACTION_UP 两 个 触摸 事件 。 但 如 果 用 户 在 屏幕 上 移动 手指 ,然后 
再 抬 起 手指 , 则 会 产生 这 样 的 事件 序列 ACTION _DOWN 一 ACTION _ MOVE 一 
ACTION_MOVE-> ACTION_MOVE 一 ……~ACTION_UP。 

在 手机 上 运行 的 应 用 程序 ,效率 是 非常 重要 的 。 如 果 Android 界面 框架 不 能 产生 足 
够 多 的 触摸 事件 , 则 应 用 程序 就 不 能 够 很 精确 地 描绘 触摸 屏 上 的 触摸 轨迹 。 相 反 , 如 果 
Android 界面 框架 产生 了 过 多 的 触摸 事件 ,虽然 能 够 满足 精度 的 要 求 ,但 却 降低 了 应 用 程 
序 效率 。Android 界面 框架 使 用 了 “打包 ”的 解决 方法 。 在 触 点 移动 速度 较 快 时 会 产生 大 
量 的 数据 ,每 经 过 一 定 的 时 间 间 隔 便 会 产生 一 个 ACTION. MOVE 事件 ,在 这 个 事件 中 ， 
除了 有 当前 触 点 的 相关 信息 外 ,还 包含 这 段 时 间 间 隔 内 和 触 点 轨迹 的 历史 数据 信息 ,这 样 
既 能 够 保持 精度 ,有 不 至 于 产生 过 多 的 触摸 事件 。 通 常情 况 下 ,在 ACTION_MOVE 的 
事件 处 理 函 数 中 ,都 先 处 理 历史 数据 ,然后 再 处 理 当 前 数据 。 


Private int ProcessHistory (MotionEvent event) 
t 
int historySize- event .getHistorySize(); 


for (int i-0; i «historySize; і++) { 


t 

2 

3 

4 

5 long time=event .getHistoricalEventTime (i); 

6 float pressure- event.getHistoricalPressure (i); 
7 float x-event.getHistoricalX(i); 

8 float y-event.getHistoricalY (i); 

9 float size- event.getHistoricalSize (i); 

10 


11 // 处 理 过 程 .……- 
12 ) 

13 return historySize; 
14 y 


在 ProcessHistory O PR rr. 35 3 行 代码 获取 历史 数据 的 数量 ,然后 在 第 4 行 至 
12 行 中 循环 处 理 这 些 历史 数据 。 第 5 行 代码 获取 历史 事件 的 发 生 时 间 ,第 6 行 代码 获取 
历史 事件 的 触 点 压力 ,第 7 行 和 第 8 行 代码 获取 历史 事件 的 相对 坐标 ,第 9 行 获取 历史 事 
件 的 触 点 尺寸 。 在 第 13 行 返回 历史 数据 的 数量 ,主要 是 用 于 界面 显示 。 

Android 模拟 器 并 不 支持 触 点 压力 和 触 点 尺寸 的 模拟 ,所 有 触 点 压力 恒 为 1.0, 触 点 
尺寸 恒 为 0.0。 同 时 ,在 Android 模拟 器 上 也 无 法 产生 历史 数据 ,因此 历史 数据 量 一 直 显 
示 为 0。 


144 hdroid 应 用 程序 开发 (第 3 版 ) 


= 


B 


1. 简 述 6 种 界面 布局 的 特点 。 
2. 参考 图 5. 44 中 界面 控件 的 摆 放 位 置 ,使 用 多 种 布局 方法 实现 用 户 界 
种 布局 实现 的 复杂 程度 和 对 不 同 屏幕 尺寸 的 适应 能 力 。 


外 ,并 对 比 各 


添加 数 ” 全 部 显 ARE ед 
JE = = 除 


图 5.44 界面 示例 


3. 简 述 Android 系统 三 种 菜单 的 特点 及 其 使 用 方式 。 
1. 说 明 使 用 操作 栏 为 程序 开发 所 带 来 的 便利 。 


组 件 通信 与 广播 消息 


Intent 是 一 种 消息 传递 机 制 , 用 于 组 件 之 间 数 据 交 换 和 发 送 广播 消息 。 通 过 本 章 的 
学 习 可 以 让 读者 了 解 Android 系统 的 组 件 通信 原理 ,掌握 利用 Intent 启动 其 他 组 件 , 以 
及 获取 信息 和 发 送 广播 消息 的 方法 。 

本 章 学 习 目 标 : 

* 了 和 解 使 用 Intent 进行 组 件 通 信 的 原理 ; 

。 掌握 使 用 Intent 启动 Activity 的 方法 ; 

。 掌握 获取 Activity 返回 值 的 方法 ; 

。 了 解 Intent 过 滤器 的 原理 与 匹配 机 制 ; 

° 掌握 发 送 和 接收 广播 消息 的 方法 。 
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Intent 是 一 种 轻 量 级 的 消息 传递 机 制 , 可 以 在 同一 个 应 用 程序 内 部 的 不 同 组 件 之 间 
传递 信息 ,也 可 以 在 不 同 应 用 程序 的 组 件 之 间 传 递 信息 ,还 可 以 作为 广播 事件 发 布 
Android 系统 消息 。 由 于 Intent 的 存在 ,使 得 Android 系统 中 互相 独立 的 组 件 成 为 了 一 
个 可 以 互相 通信 的 组 件 集合 。 因 此 ,无 论 这些 组 件 是 否 在 同一 个 应 用 程序 中 ,Intent 都 可 
以 将 一 个 组 件 的 数据 或 动作 传递 给 另 一 个 组 件 。 

Intent 是 一 个 动作 的 完整 描述 ,包含 了 动作 的 产生 组 件 、 接 收 组 件 和 传递 的 数据 信 
E, ,接收 组 件 在 接收 到 Intent 所 传递 的 消息 后 ,会 执行 响应 的 动作 。 因 此 ,Intent 可 以 非 
常 方便 地 启动 其 他 组 件 , 如 启动 Activity 或 Service; Intent 支持 显 式 或 隐 式 启动 组 件 ， 
显 式 启动 需要 指明 需要 加 载 组 件 的 类 , 隐 式 启动 则 无 须 指明 具体 的 类 ,只 要 提供 需要 处 
理 的 数据 或 动作 即 可 。 隐 式 启 动 的 好 处 是 不 必 与 某 个 具体 的 组 件 耦 合 ,降低 了 Android 
系统 中 组 件 之 间 的 耦合 度 , 有 利于 组 件 分 离 ,并 允许 无 缝 地 替换 应 用 程序 中 的 元 素 。 

Intent 的 另 一 个 用 途 是 在 Android 系统 上 发 布 广播 消息 。 广 播 消息 可 以 是 程序 的 内 
部 消息 ,可 以 是 第 三 方程 序 发 出 的 消息 ,也 可 以 是 Android 系统 消息 ,如 手机 的 信号 变化 
或 电池 的 电量 过 低 等 信息 。 任 何 程 序 都 可 以 根据 需要 发 布 广播 消息 ,其 他 程序 也 可 以 通 
过 注册 Intent 过 滤器 获得 这 些 广播 消息 。 
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611 启动 Activity 


在 Android 系统 中 ,应 用 程序 一 般 都 有 多 个 Activity. Intent 可 以 实现 不 同 Activity 
之 间 的 切换 和 数据 传递 。Intent 启动 Activity 方式 可 以 分 为 显 式 启动 和 隐 式 启动 。 显 式 
启动 必须 在 Intent 中 指明 启动 的 Activity 所 在 的 类 ,而 隐 式 启动 则 由 Android 系统 , 根 
据 Intent 的 动作 和 数据 来 决定 启动 哪 一 个 Activity。 也 就 是 说 在 隐 式 启动 时 ,Intent 中 
只 包含 需要 执行 的 动作 和 所 包含 的 数据 ,而 无 须 指 明 具 体 启 动 哪 一 个 Activity, 选 择 权 有 
Android 系统 和 最 终 用 户 来 决定 。 

(1) 显 式 启动 

使 用 Intent 来 显 式 启 动 Activity, 首 先 需要 创建 一 个 Intent ,并 为 它 指定 当前 的 应 用 
程序 上 下 文 以 及 要 启动 的 Activity, 把 创建 好 的 Intent 作为 参数 传递 给 startActivity() 方 
法 。 

1 Intent intent= new Intent (IntentDemo.this, ActivityToStart.class); 


2 startActivity (intent); 


下 面 用 IntentDemo 示例 说 明 如 何 使 用 Intent 启动 新 的 Activity, IntentDemo 示例 
包含 两 个 Activity, 分 别 是 IntentDemoActivity 和 NewActivity。 程 序 默认 启动 的 
Activity 是 IntentDemo ,在 用 户 点 击 “* 启 动 Activity” 按 钮 后 ,程序 启动 的 Activity 是 
NewActivity, 如 图 6. 1 所 示 。 


IntentDemo IntentDemo 


启动 ACTIVITY 


(a) IntentDemoActivity (b) NewActivity 


6.1 IntentDemo 示例 用 户 界 面 


在 IntentDemo 示例 中 使 用 了 两 个 Activity, 因 此 需要 在 AndroidManifest. xml 文件 
中 注册 这 两 个 Activity。 注 册 Activity 应 使 用 二 activity 二 标签 CE TE application T4 
签 内 部 。 
AndroidManifest. xml 文件 代码 如 下 。 
<? хп] version- "1.0" encoding- "utf- 8"? > 
«manifest xmlns:android- "http: //schemas .android.com/apk/res/android" 


package- "edu.hrbeu.IntentDemo" 


android:versionName- "1.0"> 


a 
3 
4 android:versionCode- "1" 
5 
6 


«application android:icon- "ё drawable/icon" android:label- 


"Qstring/app name" 


EI 


«activity android:name- ".IntentDemo" 


8 android:label- "@ string/app name" 
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9 <іпёепі- filter> 

10 « action android:name- "android.intent.action.MAIN" /> 

11 «category android:name= "android.intent.category.LAUNCHER" /> 
42 < /intent- filter» 

13 < /activity> 

14 <activity android:name= ".NewActivity" 

15 android:label- "6 string/app папе"> 

16 < /activity» 

ry < /application» 

18 «uses- sdk android:minSdkVersion- "14" /> 


19 «/manifest» 


Android 应 用 程序 中 ,用 户 使 用 的 每 个 组 件 都 必须 在 AndroidManifest. xml 文件 中 
fif) application 之 节点 内 定义 。 在 上 面 的 代码 中 ,去 application 之 节点 下 共有 两 个 
<activity>> 158 ,分别 代 表 应 用 程序 中 所 使 用 的 两 个 Activity. IntentDemoActivity 和 
NewActivity。 

在 IntentDemoActivity. java 文件 中 ,包含 了 使 用 Intent 启动 Activity 的 核心 代码 。 


1 Button button- (Button) findViewById(R.id.btn); 

2 button.setOnClickListener (new OnClickListener () ( 

3 public void onClick (View view) { 

4 Intent intent- new Intent (IntentDemoActivity.this, 
NewActivity.class); 

5 startActivity (intent); 

6 } 


7 р 


在 点 击 事件 的 处 理 函 数 中 ,Intent 构造 函数 的 第 1 个 参数 是 应 用 程序 上 下 文 , 在 这 里 
就 是 IntentDemoActivity; 第 2 个 参数 是 接收 Intent 的 目标 组 件 ,这 里 使 用 的 是 显 式 启动 
方式 ,直接 指明 了 需要 启动 的 Activity。 

(2) 隐 式 启动 

隐 式 启动 的 好 处 在 于 不 需要 指明 需要 启动 哪 一 个 Activity, 而 由 Android 系统 来 决 
定 , 这 样 有 利于 降低 组 件 之 间 的 耦合 度 。 

选择 隐 式 启动 Activity. Android 系统 会 在 程序 运行 时 解析 Intent, 并 根据 一 定 的 规 
则 对 Intent 和 Activity 进行 匹配 ,使 Intent 上 的 动作 .数据 与 Activity 完全 吻合 。 匹 配 
的 组 件 可 以 是 程序 本 身 的 Activity, 也 可 以 是 Android 系统 内 置 的 Activity, 还 可 以 是 第 
三 方 应 用 程序 提供 的 Activity。 因 此 ,这 种 方式 强调 了 Android 组 件 的 可 复 用 性 。 

例如 ,如 果 程 序 开发 人 员 和 希望 启动 一 个 浏览 器 ,查看 指定 的 网 页 内 容 , 却 不 能 确定 具 
体 应 该 启动 哪 一 个 Activity, 此 时 则 可 以 使 用 Intent 的 隐 式 启动 方式 ,由 Android 系统 在 
程序 运行 时 决定 具体 启动 哪 一 个 应 用 程序 的 Activity 来 接收 这 个 Intent。 程 序 开 发 人 员 
可 以 将 浏览 动作 和 Web 地 址 作为 参数 传递 给 Intent, Android 系统 则 通过 匹配 动作 和 数 
据 格 式 ,找到 最 适合 此 动作 和 数据 格式 的 组 件 。 
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y Intent intent- пем Intent (Intent.ACTION VIEW, Uri.parse ("http://www.baidu. 


com")); 


2 StartActivity (intent); 


Intent 的 动作 是 Intent. ACTION. VIEW. ЖС E: Web 地 址 ,使 用 Uri. parseCurlString) 
方法 ,可 以 简单 地 把 一 个 字符 串 解 释 成 Uri 对 象 。Android 系统 在 匹配 Intent 时 ,首先 根 
JE SIME Intent. ACTION_VIEW, 得 知 需 要 启动 具备 浏览 功能 的 Activity, 但 具体 是 浏览 
电话 号 码 还 是 浏览 网 页 ,还 需要 根据 URI 的 数据 类 型 来 做 最 后 判断 。 因 为 数据 提供 的 是 
Web 地 址 http://www. baidu. com, 所 以 最 终 可 以 判定 Intent 需要 启动 具有 网 页 浏览 功 
能 的 Activity。 在 默认 情况 下 ,Android 系统 会 调用 内 置 的 Web 浏览 器 。 


Intent 的 语法 如 下 。 


i Intent intent- new Intent (Intent.ACTION VIEW, Uri.parse(urlString)); 


Intent 构造 函数 的 第 1 个 参数 是 Intent 需要 执行 的 动作 ,Android 系统 支持 的 常见 
动作 字符 串 常 量 可 以 参考 表 6.1。 第 2 个 参数 是 URI, 表 示 需 要 传递 的 数据 。 


动 作 


表 6.1 Intent 常用 动作 
说 HH 


ACTION_ANSWER 


打开 接听 电话 的 Activity, 默 认为 Android 内 置 的 拨号 界面 


ACTION_CALL 


打开 拨号 盘 界面 并 拨打 电话 ,使 用 Uri 中 的 数字 部 分 作为 电话 号 码 


ACTION_DELETE 


打开 一 个 Activity, 对 所 提供 的 数据 进行 删除 操作 


ACTION_DIAL 


打开 内 置 拨号 界面 ,显示 Uri 中 提供 的 电话 号 码 


ACTION_EDIT 


打开 一 个 Activity, 对 所 提供 的 数据 进行 编辑 操作 


ACTION_INSERT 


打开 一 个 Activity, 在 提供 数据 的 当前 位 置 插 入 新 项 


ACTION_PICK 


启动 一 个 子 Activity, 从 提供 的 数据 列表 中 选取 一 项 


ACTION_SEARCH 


启动 一 个 Activity ,执行 搜索 动作 


ACTION_SENDTO 


启动 一 个 Activity, 向 数据 提供 的 联系 人 发 送信 息 


ACTION_SEND 


启动 一 个 可 以 发 送 数据 的 Activity 


ACTION_VIEW 


最 常用 的 动作 ,对 以 Uri 方式 传送 的 数据 ,根据 Uri 协议 部 分 以 最 佳 方 
式 启 动 相应 的 Activity 进行 处 理 。 对 于 http:address 将 打开 浏览 器 查 
看 ;对 于 tel:address 将 打开 拨号 界面 并 呼叫 指定 的 电话 号 码 


ACTION_WEB_SEARCH 


打开 一 个 Activity, 对 提供 的 数据 进行 Web 搜索 


WebViewIntentDemo 示例 演示 如 何 隐 式 启 动 Activity, 用 户 界 面 如 图 6. 2(a) 所 示 。 

当 用 户 在 文本 框 中 输入 Web 地 址 后 ,通过 点 击 * 浏 览 此 URL” 按 钮 ,程序 根据 用 户 输 
入 的 Web 地 址 生成 一 个 Intent ,并 以 隐 式 启动 的 方式 调用 Android 内 置 的 Web 浏览 器 ， 
并 打开 指定 的 Web 页 面 。 本 例 输入 的 Web 地 址 http://www. baidu. com, 打 开 页 面 后 


的 效果 如 图 6.2(b) 所 示 。 
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WebViewlntentDemo 


http://www.baidu.com 


浏览 此 URL 


$- 百度 -下 


新 闻 贴吧 视频 网 址 地 图 更 多 


(a) 输入 网 址 界面 (b) 打开 Web 后 的 界面 
图 6.2 WebViewIntentDemo 用 户 界面 


612 获取 Activity 返 回 值 


在 上 一 小 节 IntentDemo 示例 中 ,通过 startActivity(Intent) 方 法 启动 Activity, 启 动 
后 的 两 个 Activity 之 间 相 互 独 立 , 没 有 任何 的 关联 。 在 很 多 情况 下 ,后 启动 的 Activity 是 
为 了 让 用 户 对 特定 信息 进行 选择 ,在 后 启动 的 Activity 关闭 时 ,这 些 信息 是 需要 返回 给 
先前 启动 的 Activity。 后 启动 的 Activity 称 为 * 子 Activity”, 先 启动 的 Activity 称 为 “ 父 
如 果 需 要 将 子 Activity 的 信息 返回 给 父 Activity, 则 可 以 使 用 Sub-Activity 


Activity”。 
的 方式 去 启动 子 Activity。 
获取 子 Activity 的 返回 值 ,一 般 可 以 分 为 以 下 三 个 步骤 ， 
(1) 以 Sub-Activity 的 方式 启动 子 Activity: 
(2) 设置 子 Activity 的 返回 值 ; 
(3) 在 父 Activity 中 获取 返回 值 。 
下 面 详细 介绍 每 一 个 步 又 的 过 程 和 代码 实现 。 


1. 以 Sub-Activity 的 方式 启动 子 Activity 


以 Sub-Activity 方式 启动 子 Activity, 需要 调用 startActivityForResult (Intent, 
requestCode) 函数 ,参数 Intent 用 于 决定 启动 哪个 Activity, 参 数 requestCode 是 请 求 码 。 
因为 所 有 子 Activity 返回 时 , 父 Activity 都 调用 相同 的 处 理 函 数 ,因此 父 Activity 使 用 
requestCode 来 确定 数据 是 哪 一 个 子 Activity 返回 的 。 

显 式 启动 子 Activity 的 代码 如 下 。 

int SUBACTIVITY1=1; 


1 
= Intent intent=new Intent (this, SubActivityl.class); 
3 


startActivityForResult (intent, SUBACTIVITY1); 


隐 式 启动 子 Activity 的 代码 如 下 。 
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int SUBACTIVITY2- 2; 
Uri uri-Uri.parse ("content: //contacts/people"); 
Intent intent- new Intent (Intent.ACTION PICK, uri); 


& (Q Hd 


startActivityForResult (intent, SUBACTIVITY2); 


2. 设置 子 Activity 的 返回 值 


在 子 Activity 调用 finish O PR £ 2& BI] Bü. 38] H] setResult O 函数 设 定 需要 返回 给 父 
Activity 的 数据 。setResult() 函数 有 两 个 参数 ,一 个 是 结果 码 ,一 个 是 返回 值 。 结 果 码 表 
明子 Activity 的 返回 状态 ,通常 为 Activity. RESULT_OK( 正 常 返回 数据 ) 或 者 Activity 
. RESULT_CANCELED( 取 消 返 回 数据 ), 也 可 以 是 自 定义 的 结果 码 ,结果 码 均 为 整数 类 
型 。 返 回 值 封装 在 Intent 中 ,也 就 是 说 子 Activity 通过 Intent 将 需要 返回 的 数据 传递 给 
父 Activity。 数 据 主 要 以 Uri 形式 返回 给 父 Activity, 此 外 还 可 以 附加 一 些 额外 信息 ,这 
些 额 外 信息 用 Extra 的 集合 表示 。 

以 下 代码 说 明 如 何在 子 Activity 中 设置 返回 值 。 


Uri data=Uri.parse("tel:"+tel number); 
Intent result- new Intent (null, data); 


1 
2 
3 result.putExtra ("address", "JD Street"); 
4 setResult (RESULT OK, result); 

5 


finish(); 


3. ТЕЗ Activity 中 获取 返回 值 


当 子 Activity 关闭 后 , 父 Activity 会 调用 onActivityResult ( ) 函数 ,用 来 获取 子 
Activity 的 返回 值 。 如 果 需 要 在 父 Activity 中 处 理子 Activity 的 返回 值 , 则 重 载 此 函数 
即 可 。onActivityResult() 函数 的 语法 如 下 。 


1 public void onActivityResult (int requestCode, int resultCode, Intent data); 


其 中 第 1 个 参数 requestCode 是 请 求 码 ,用 来 判断 第 3 个 参数 是 哪 一 个 子 Activity 的 返 
回 值 ;resultCode 用 于 表示 子 Activity 的 数据 返回 状态 ;Data 是 子 Activity 的 返回 数据 ， 
返回 数据 类 型 是 Intent。 根 据 返 回 数据 的 用 途 不 同 ,Uri 数据 的 协议 则 不 同 , 也 可 以 使 用 
Extra 方法 返回 一 些 原始 类 型 的 数据 。 

以 下 代码 说 明 如 何在 父 Activity 中 处 理子 Activity 的 返回 值 。 


private static final int SUBACTIVITY1=1; 
private static final int SUBACTIVITY2=2; 


@ Override 

public void onActivityResult (int requestCode, int resultCode, Intent data){ 
Super.onActivityResult (requestCode, resultCode, data); 
switch (requestCode) { 


cO ы су O > шю н 


сазе SUBACTIVITY1: 
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9 if (resultCode==Activity.RESULT ОК) { 
10 Uri uriData=data.getData (); 

hod Jelse if (resultCode-- Activity.RESULT CANCEL) { 
12 ) 

13 break; 

14 case SUBACTIVITY2: 

15 if(resultCode-- Activity.RESULT ОК) { 
16 Uri uriData- data.getData (); 

17 ) 

18 break; 

19 } 

20 ) 


代码 的 第 1 行 和 第 2 行 是 两 个 子 Activity 的 请 求 码 ,在 第 7 行 对 请 求 码 进行 匹配 。 
代码 第 9 行 和 第 11 行 对 结果 码 进行 判断 ,如 果 返 回 的 结果 码 是 Activity. RESULT. OK. 
则 在 代码 的 第 10 行使 用 getData() 函数 获取 Intent 中 的 Uri 数据 ;如 果 返 回 的 结果 码 是 
Activity. RESULT_CANCELED, 则 放弃 所 有 操作 。 

ActivityCommunication 示例 演示 了 如 何以 Sub-Activity 方式 启动 子 Activity, 以 及 
如 何 使 用 Intent 进行 组 件 间 通 信 。 

该 示例 的 主 界面 如 图 6. 3 所 示 。 当 用 户 点 击 “ 启 动 Activity1” 和 “启动 Activity2” 按 
钮 时 ,程序 将 分 别 启 动 子 SubActivityl 和 SubActivity2, 如 图 6.4 所 示 。SubActivityl 提 


9.0 10:53 


ActivityCommunication 


启动 ACTIVITY1 


启动 ACTIVITY2 


图 6.3 ActivityCommunication 用 户 界面 


9. 0 10:54 


ActivityCommunication ActivityCommunication 


Input here 


(a) SubActivityl (b) SubActivity2 


图 6.4  ActivityCommunication 的 两 个 子 Activity 


152 


Osanna 3 版 ) 


供 了 一 个 输入 框 ,以 及 “接受 ”和 “撤销 ”两 个 按钮 。 如 果 在 输入 框 中 输入 信息 后 点 击 “ 接 
受 " 按 钮 ,程序 会 把 输入 框 中 的 信息 传递 给 其 父 Activity, 并 在 父 Activity 的 界面 上 显示 。 
而 如 果 用 户 点 击 “ 撤 销 ” 按 钮 , 则 程序 不 会 向 父 Activity 传递 任何 信息 。SubActivity2 = 
要 是 为 了 说 明 如 何在 父 Activity 中 处 理 多 个 子 Activity, 因 此 仅 提供 了 用 于 关闭 
SubActivity2 的 “关闭 ”按钮 。 

ActivityCommunication 示例 的 文件 结构 如 图 6. 5 所 示 , 父 Activity 的 代码 在 
ActivityCommunication. java 文件 中 ,界面 布局 在 main. xml 中 ;两 个 子 Activity 的 代码 
分 别 在 SubActivityl. java 和 SubActivity2. java 文件 中 ,界面 布局 分 别 在 subactivityl 
. xml 和 subactivity2. xml 中 。 


> юй Google APIs [Android 5.0.1] 
4 (9 src 
4 8 edu.hrbeu.Activit/Communication 
> [D ActivityCommunicationActivity java 
> [0 SubActivityLjava 
> [D SubActivity2java 
> Ë8 gen [Generated Java Files] 
B assets 
b B bin 
4 Ф res 
> Ф drawable-hdpi 
> © drawable-Idpi 
> © drawable-mdpi 
© drawable-xhdpi 
4 © layout 
В mainxml 
В subactiviylxml 
В subactivity2xml 
b © values 
В AndroidManifestxml 
国 proguard.cfg 
В project.properties 


6.5 ActivityCommunication 文件 结构 


ActivityCommunicationActivity. java 文件 的 核心 代码 如 下 。 


1 public class ActivityCommunicationActivity extends Activity ( 
2 private static final int SUBACTIVITY1-1; 

3 private static final int SUBACTIVITY2-2; 

4 TextView textView; 

5 @override 

6 public void onCreate (Bundle savedInstanceState)( 

F super .onCreate (savedInstanceState); 

8 setContentView (R.layout .main); 

9 textView= (TextView)findViewById (R.id.textShow); 
10 final Button btnl- (Button) ҒіпауіемВута (R.id.btnl); 
Ad final Button btn2- (Button) findViewById (R.id.btn2); 
a2 

13 btnl.setOnClickListener (new OnClickListener () ( 


14 public void onClick (View view) { 
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15 Intent intent=new Intent (ActivityCommunication.this, 


SubActivityl.class); 


16 startActivityForResult (intent, SUBACTIVITY1); 

17 } 

18 n; 

19 

20 btn2.setOnClickListener (new OnClickListener () ( 

21 public void onClick (View view) { 

22 Intent intent- new Intent (ActivityCommunication.this, 
SubActivity2.class); 

23 startActivityForResult (intent, SUBACTIVITY2); 

24 } 

25 n; 

26 y 

27 

28 @ Override 

29 protected void onActivityResult (int requestCode, int resultCode, Intent data)( 

30 super.onActivityResult (requestCode, resultCode, data); 

31 

32 switch (requestCode) { 

33 case SUBACTIVITY1: 

34 if (resultCode-- RESULT OK)( 

35 Uri uriData- data.getData (); 

36 textView.setText (uriData.toString()); 

37 } 

38 break; 

39 case SUBACTIVITY2: 

40 break; 

41 } 

42 } 

43 } 


在 代码 的 第 2 行 和 第 3 行 分 别 定义 了 两 个 子 Activity 的 请 求 码 。 在 代码 的 第 16 行 
和 第 23 行 以 Sub-Activity 的 方式 分 别 启动 两 个 子 Activity。 代 码 第 29 行 是 子 Activity 
关闭 后 的 返回 值 处 理 函 数 , 其 中 requestCode 是 子 Activity 返回 的 请 求 码 ,与 第 2 行 和 第 
3 行 定义 的 两 个 请 求 码 相 匹配 ;resultCode 是 结果 码 , 在 代码 第 32 行 对 结果 码 进 行 判断 ， 
如 果 等 于 RESULT_OK ,在 第 35 行 代码 获取 子 Activity 返回 值 中 的 数据 ;data 是 返回 
值 , 子 Activity 需要 返回 的 数据 就 保存 在 data 中 。 

SubActivityl. java 的 核心 代码 如 下 。 


public class SubActivityl extends Activity { 
@override 
public void onCreate (Bundle savedInstancesState) { 
super .onCreate (savedInstanceState); 


(UU 


setContentView (R.layout.subactivityl); 
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6 final EditText editText- (EditText)findViewById(R.id.edit); 
E Button btnOK- (Button) findViewById (R.id.btn ok); 

8 Button btnCancel- (Button) findViewById (R.id.btn cancel); 

9 


10 btnOK.setOnClickListener (new OnClickListener () ( 

11 public void onClick (View view) { 

12 String uriString-editText.getText () .toString(); 
13 Uri data-Uri.parse (uriString); 

14 Intent result- пем Intent (null, data); 

15 setResult (RESULT OK, result); 

16 finish(); 

zr ) 

18 n; 

19 

2 btnCancel.setOnClickListener (new OnClickListener () ( 
21 public void onClick (View view) { 

22 setResult (RESULT CANCELED, null); 

23 finish(); 

24 } 

25 nz 

26 } 

27 j 


代码 第 13 行将 Edit Text 控件 的 内 容 作为 数据 保存 在 Uri 中 ,并 在 第 14 行 代码 中 构 
XE Intent。 在 第 15 行 代码 中 ,RESUIT_OK 作为 结果 码 , 通 过 调用 setResult() 函数 ,将 
result 设 定 为 返回 值 。 最 后 在 代码 第 16 行 调 用 finish() 函 数 关闭 当前 的 子 Activity, 
SubActivity2. java 的 核心 代码 。 


1 public class SubActivity2 extends Activity { 

2 @override 

3 public void onCreate (Bundle savedInstanceState)( 

4 super.onCreate (savedInstanceState); 

5 setContentView (R.layout.subactivity2); 

6 

7 Button btnReturn- (Button) findViewById(R.id.btn return); 
8 btnReturn.setOnClickListener (new OnClickListener () ( 
5 public void onClick (View view) { 

10 setResult (RESULT CANCELED, null); 

11 finish (); 

12 } 

13 n; 

14 } 

15 } 


在 SubActivity2 的 代码 中 ,第 10 行 的 setResult() 函 数 仅 设置 了 结果 码 , 第 2 个 参数 
为 null, 表 示 没 有 数据 需要 传递 给 父 Activity。 
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隐 式 启动 Activity 时 ,并 没有 在 Intent 中 指明 Activity 所 在 的 类 ,因此 ,Android £ 
统一 定 存在 某 种 匹配 机 制 ,使 Android 系统 能 够 根据 Intent 中 的 数据 信息 ,找到 需要 启 
动 的 Activity。 这 种 匹配 机 制 是 依靠 Android 系统 中 的 Intent 过 滤器 (Intent Filter) 来 
实现 的 。 

Intent 过 滤器 是 一 种 根据 Intent 中 的 动作 (action) 、 类别 (category) 和 数据 (data) 等 
内 容 , 对 适合 接收 该 Intent 的 组 件 进行 匹配 和 筛选 的 机 制 。Intent 过 滤器 可 以 匹配 数据 
类 型 ,路径 和 协议 ,还 可 以 确定 多 个 匹配 项 顺序 的 优先 级 (Priority)。 应 用 程序 的 
Activity Service 和 BroadcastReceiver 组 件 都 可 以 注册 Intent 过 滤器 。 这 样 , 这 些 组 件 
在 特定 的 数据 格式 上 则 可 以 产生 相应 的 动作 。 

为 了 使 组 件 能 够 注册 Intent 过 滤器 ,通常 在 AndroidManifest. xml 文件 的 各 个 组 件 
下 定义 一 intentrfilter 之 节点 ,然后 在 二 intentrfilter 之 节点 中 声明 该 组 件 所 支持 的 动作 、 
执行 的 环境 和 数据 格式 等 信息 。 当 然 ,也 可 以 在 程序 代码 中 动态 地 为 组 件 设置 Intent 过 
滤器 。 志 intent-filter 二 节点 支持 二 action 二 标签 .一 category 二 标签 和 所 data 二 标签 ,分 
别 用 来 定义 Intent 过 滤器 的 “动作 “类别 ?和 "数据 "。 志 intentrfilter 之 节点 支持 的 标签 
和 属性 说 明 参 考 表 6.2. 


表 6.2 一 intent-filter 二 节点 属性 


标 签 m 性 说 RH 
fraus nm 指定 组 件 所 能 响应 的 动作 ,用 字符 串 表 示 , 通 常 由 Java 类 名 和 
包 的 完全 限定 名 构成 

<category> | android:category | 指定 以 何 种 方式 去 服务 Intent 请 求 的 动作 
Android: host 指定 一 个 有 效 的 主机 名 
android:mimetype | 指定 组 件 能 处 理 的 数据 类 型 

—data> android: path 有 效 的 URI 路 径 名 
android: port 主机 的 有 效 端口 号 
android:scheme 所 需要 的 特定 协议 


—category > PREH 348 л Intent 过 滤器 的 服务 方式 ,每 个 Intent 过 滤器 可 以 定义 
Z^ — category > HRE ,程序 开发 人 员 可 以 使 用 自 定义 的 类 别 , 或 使 用 Android 系统 提供 
的 类 别 。Android 系统 提供 的 类 别 可 以 参考 表 6.3. 
Ж 6.3 Android 系统 提供 的 类 别 
值 说 — BB 


ALTERNATIVE Intent 数据 默认 动作 的 一 个 可 替换 的 执行 方法 
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值 说 — BB 
SELECTED, ALTERNATIVE ы 0m 类 似 ,但 替换 的 执行 方法 不 是 指定 的 ,而 是 被 解 
BROWSABLE 声明 Activity 可 以 由 浏览 器 启动 
DEFAULT 为 Intent 过 滤器 中 定义 的 数据 提供 默认 动作 
HOME 设备 启动 后 显示 的 第 一 个 Activity 
LAUNCHER 在 应 用 程序 启动 时 首先 被 显示 


AndroidManifest. xml 文件 中 每 个 组 件 的 二 intent-filter 过 都 被 解析 成 一 个 Intent 过 
滤器 对 象 。 当 应 用 程序 安装 到 Android 系统 时 ,所 有 的 组 件 和 Intent 过 滤器 都 会 注册 到 
Android 系统 中 。 这 样 ,Android 系统 便 可 以 将 任何 一 个 Intent 请 求 通过 Intent 过 滤器 
映射 到 相应 的 组 件 上 。 

这 种 Intent 到 Intent 过 滤器 的 映射 过 程 称 为 "Intent HHT”. Intent 解析 可 以 在 所 有 
的 组 件 中 ,找到 一 个 可 以 与 请 求 的 Intent 达成 最 佳 匹配 的 Intent 过 滤器 。Android 系统 
中 Intent 解析 的 匹配 规则 如 下 : 

(1) Android 系统 把 所 有 应 用 程序 包 中 的 Intent 过 滤器 集合 在 一 起 ,形成 一 个 完 
的 Intent 过 滤器 列表 。 

(2) 在 Intent 与 Intent 过 滤器 进行 匹配 时 ,Android 系统 会 将 列表 中 所 有 Intent 过 
滤器 的 “动作 和" 类别? 与 Intent 进行 匹配 ,任何 不 匹配 的 Intent 过 滤器 都 将 被 过 滤 掉 。 
没有 指定 “动作 ”的 Intent 过 滤器 可 以 匹配 任何 的 Intent, 但 是 没有 指定 “类 别 ” 的 Intent 
过 滤器 只 能 匹配 没有 “类 别 ” 的 Intent. 

(3) 把 Intent 数据 Uri 的 每 个 子 部 与 Intent 过 滤器 的 二 data 二 标签 中 的 属性 进行 匹 
配 , 如 果 二 data 二 标签 指定 了 协议 、 主 机 名 、 路 径 名 或 MIME 类 型 ,那么 这 些 属性 都 要 与 
Intent 的 Uri 数据 部 分 进行 匹配 ,任何 不 匹配 的 Intent 过 滤器 均 被 过 滤 掉 。 

(4) 如 果 Intent 过 滤器 的 匹配 结果 多 于 一 个 , 则 可 以 根据 在 二 intent-filter 之 标签 中 
定义 的 优先 级 标签 来 对 Intent 过 滤器 进行 排序 ,优先 级 最 高 的 Intent 过 滤器 将 被 选择 。 

IntentResolutionDemo 示例 演示 如 何在 AndroidManifest. xml 文件 中 注册 Intent 过 
滤器 ,以 及 如 何 设置 一 intentfilter 二 节点 属性 来 捕获 指定 的 Intent, 

AndroidManifest. xml 的 完整 代码 如 下 。 


<?xml уегѕіоп= "1.0" encoding- "utf- 8"? > 
<manifest xmlns:android= "http://schemas.android.com/apk/res/android" 
package- "edu.hrbeu.IntentResolutionDemo" 


E! 

2 

3 

4 android:versionCode- "1" 

5 android:versionName- "1.0"> 
6 


«application android:icon- "ё drawable/icon" android:label- 


"Qstring/app name" 


EI 


«activity android:name- ".IntentResolutionDemo" 
8 android:label- "6 string/app name" 
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9 <intent-filter> 

10 <action android:name= "android.intent.action.MAIN" /> 

11 < category android:name= "android.intent.category.LAUNCHER" /> 
12 < /intent- filter» 

13 < /activity» 

14 «activity android:name- ".ActivityToStart" 

15 android:label- "6 string/app name" 

16 < intent- filter» 

17 «action android:name- "android.intent.action.VIEW" /» 

18 < category android:name- "android.intent.category.DEFAULT" /> 
19 < data android:scheme- "schemodemo" android:host- "edu.hrbeu" /> 
20 < /intent- filter» 

21 « /activity» 

22 « /application» 

23 «uses- sdk android:minSdkVersion- "14" /> 


24 «/manifest» 

在 代码 的 第 7 行 和 第 14 行 分 别 定义 了 两 个 Activity, Ж 9 行 一 第 12 行 是 第 1 个 
Activity 的 Intent 过 滤器 ,动作 是 android. intent. action. MAIN. ,类 别 是 android. intent 
. category. LAUNCHER, ,由 此 可 知 , 这 个 Activity 是 应 用 程序 启动 后 显示 的 默认 用 户 界面 。 

第 16 行 一 第 20 行 是 第 2 个 Activity 的 Intent 过 滤器 ,过 滤器 的 动作 是 android 
. intent. action. VIEW ,表示 根据 Uri 协议 ,以 浏览 的 方式 启动 相应 的 Activity; 类 别 是 
android. intent. category. DEFAULT., 表 示 数 据 的 默认 动作 ;数据 的 协议 部 分 是 android: 
scheme 一 "schemodemo" ,数据 的 主机 名 称 部 分 是 android; host — "edu. hrbeu " 。 

在 IntentResolutionDemo. java 文件 中 ,定义 了 一 个 Intent 用 来 启动 男 一 个 Activity, 这 
个 Intent 与 Activity 设置 的 Intent 过 滤器 是 完全 匹配 的 。IntentResolutionDemo. java 文件 
中 Intent 实例 化 和 启动 Activity 的 代码 如 下 : 


1 Intent intent- new Intent (Intent.ACTION VIEW, Uri.parse ("schemodemo://edu.hrbeu/ 
path"); 

2 startActivity (intent); 

代码 第 1 行 所 定义 的 Intent. z/ifE2J Intent. ACTION. VIEW, 5j Intent 过 滤器 的 动 
{Е android. intent. action. VIEW 匹配 ; Uri 是 schemodemo: //edu. hrbeu/path ,其 中 的 协 
议 部 分 为 schemodemo ,主机 名 部 分 为 edu. hrbeu, 也 与 Intent 过 滤器 定义 的 数据 要 求 完 
全 匹配 。 因 此 ,代码 第 1 行 定义 的 Intent, Æ Android 系统 与 Intent 过 滤器 列表 进行 匹配 
时 ,会 与 AndroidManifest. xml 文件 中 ActivityToStart 定义 的 Intent 过 滤器 完全 匹配 。 
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Intent 的 另 一 种 用 途 是 发 送 广播 消息 ,应 用 程序 和 Android 系统 都 可 以 使 用 Intent 
发 送 广播 消息 ,广播 消息 的 内 容 可 以 是 应 用 程序 密切 相关 的 数据 信息 ,也 可 以 是 Android 
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的 系统 信息 ,例如 网 络 连接 变化 .电池 电量 变化 ,接收 到 短信 或 系统 设置 变化 等 。 如 果 应 
用 程序 注册 了 BroadcastReceiver, 则 可 以 接收 指定 的 广播 消息 。 

使 用 Intent 发 送 广 播 消 息 非常 简单 ,只 需 创 建 一 个 Intent, 并 调用 sendBroadcast() 
函数 就 可 把 Intent 携带 的 信息 广播 出 去 。 但 需要 注意 的 是 ,在 构造 Intent 时 必须 定义 一 
个 全 局 唯一 的 字符 串 ,用 来 标识 其 要 执行 的 动作 ,通常 使 用 应 用 程序 包 的 名 称 。 如 果 要 
在 Intent 传递 额外 数据 ,可 以 用 Intent 的 putExtra() 方 法 。 下 面 的 代码 构造 用 于 广播 消 
息 的 Intent, 并 添加 了 额外 的 数据 ,然后 调用 sendBroadcast() 发 送 广播 消息 : 


String UNIQUE STRING- "edu.hrbeu.BroadcastReceiverDemo"; 


Intent intent- new Intent (UNIQUE STRING); 


1 
2 
3 intent.putExtra("keyl", "valuel"); 
4 intent.putExtra ("key2", "value2"); 
5 


sendBroadcast (intent); 

BroadcastReceiver 用 于 监听 广播 消息 ,可 以 在 AndroidManifest. xml 文件 或 在 代码 

中 注册 一 个 BroadcastReceiver, 并 使 用 Intent 过 滤器 指定 要 处 理 的 广播 消息 。 创 建 

BroadcastReceiver 需 继 承 BroadcastReceiver 类 ,并 重 载 onReceive() 方 法 。 示 例 代 码 
如 下 。 

public class MyBroadcastReceiver extends BroadcastReceiver { 


@ Override 


public void onReceive (Context context, Intent intent){ 


//TODO: React to the Intent received. 


ол ьш мю P 


) 

当 Android 系统 接收 到 与 注册 Broadcast 
Receiver 匹配 的 广播 消息 时 , Android 系统 会 自动 Mat 
调用 这 个 BroadcastReceiver 接收 广播 消息 。 在 Test messagel 
BroadcastReceiver 接收 到 与 之 匹配 的 广播 消息 后 ， 
onReceive() 方 法 会 被 调用 ,但 onReceive() 方 法 必 
须要 在 5 秒 钟 执行 完毕 ,否则 Android 系统 会 认为 
该 组 件 失去 响应 ,并 提示 用 户 强行 关闭 该 组 件 。 

BroadcastReceiverDemo 示例 说 明了 如 何在 应 
用 程序 中 注册 BroadcastReceiver 组 件 ,并 指定 接收 
广播 消息 的 类 型 。BroadcastReceiverDemo 示例 的 
界面 如 图 6. 6 所 示 , 在 点 击 “ 发 送 广播 消息 ”按钮 
后 ,EditText 控件 中 内 容 将 以 广播 消息 的 形式 发 送 
出 去 ,示例 内 部 的 BroadcastReceiver 将 接收 这 个 广 ыш 
播 消息 ,并 显示 在 用 户 界 面 的 下 方 。 

BroadcastReceiverDemo. java 文件 中 包含 发 送 
广播 消息 的 代码 ,其 关键 代码 如 下 。 


发 送 广播 消息 


图 6.6  BroadcastReceiverDemo 主 界面 


2s 组 件 通信 和 与 广播 消息 
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1 button.setOnClickListener (new OnClickListener () ( 


2 public void onClick (View view) { 

3 Intent intent- new Intent ("edu.hrbeu.BroadcastReceiverDemo"); 
4 intent.putExtra ("message", entryText.getText ().toString()); 
5 sendBroadcast (intent); 

6 } 

7T pi 


[rib š 
代码 第 3 行 创建 Intent 时 ,将 edu. hrbeu. BroadcastReceiverDemo 作为 识别 广播 消 
息 的 字符 串 标识 ,并 在 代码 第 4 行将 添加 了 额外 信息 ,最 后 在 代码 第 5 行 调用 
sendBroadcast() 函 数 发 送 广播 消息 。 
为 了 能 够 使 应 用 程序 中 的 BroadcastReceiver 接收 指定 的 广播 消息 ,首先 要 在 
AndroidManifest. xml 文件 中 BroadcastReceiver 节点 下 添加 Intent 过 滤器 ,声明 
BroadcastReceiver 可 以 接收 的 广播 消息 类 型 。AndroidManifest. xml 文件 的 完整 代码 如 下 。 


£ < ?xm1 version- "1.0" encoding- "utf- 8"?» 
2 «manifest xmlns:android- "http://schemas .android.com/apk/res/android" 


3 package- "edu .hrbeu.BroadcastReceiverDemo" 
4 android:versionCode- "1" 
5 android:versionName- "1.0"» 
6 «application android:icon- "ё drawable/icon" android:label- "? string/app name" 
Y «activity android:name- ".BroadcastReceiverl i 
android:label="@ string/app_name"> 
9 «intent- filter» 
10 « action android:name- "android.intent.action.MAIN" /» 
11 «category android:name- "android.intent.category.LAUNCHER" /> 
12 < /intent- filter» 
13 < /activity> 
14 «receiver android:name= " .MyBroadcastReceiver"> 
15 <intent-filter> 
16 «action android:name= "edu.hrbeu.BroadcastReceiverDemo" /> 
ay < /intent- filter» 
18 < /receiver» 
19 < /application» 
20 « uses- sdk android:minSdkVersion- "14" /> 


21 «/manifest» 


在 代码 的 第 14 fp Th © Т И receiver 15 5x TES 15 行 中 声明 了 Intent 过 滤器 
的 动作 为 edu. hrbeu. BroadcastReceiverDemo.3X 5 BroadcastReceiverDemo. java 文件 中 
Intent 的 动作 相 一 致 ,表明 这 个 BroadcastReceiver 可 以 接收 动作 为 edu. hrbeu. 
BroadcastReceiverDemo 的 广播 消息 。 

MyBroadcastReceiver. java 文件 创建 了 一 个 自 定 义 的 BroadcastReceiver, 其 核心 代 
码 如 下 。 
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public class MyBroadcastReceiver extends BroadcastReceiver { 
@override 
public void onReceive (Context context, Intent intent) { 


String msg-intent.getStringExtra ("message"); 


Toast.makeText (context, msg, Toast.LENGTH SHORT).show(); 


чо ләш M PP 


) 


代码 第 1 行 首 先 继承 了 BroadcastReceiver 类 ,并 在 第 3 1138 2X Y onReveiveO 函数 。 
当 接 收 到 AndroidManifest. xml 文件 定义 的 广播 消息 后 ,程序 将 自动 调用 onReveiveO 
函数 进行 消息 处 理 。 代 码 第 4 行 通过 调用 getStringExtra() 函 数 , 从 Intent 中 获取 标识 
为 message 的 字符 串 数 据 ,并 使 用 Toast() 函数 将 信息 显示 在 界面 上 。 


= zh 


. РЖ Intent 的 定义 和 用 途 。 
. РЖ Intent 过 滤器 的 定义 和 功能 。 
. H Intent 解析 的 匹配 规则 。 

.编程 实现 具有 “登录 ”按钮 的 主 界面 ,点 击 “ 登 录 ” 按 钮 后 打开 一 个 新 的 Activity, 
新 打开 的 Activity 上 面 有 输入 用 户 名 和 密码 的 控件 。 在 用 户 关闭 这 个 Activity 后 ,将 用 
户 名 和 密码 传递 到 主 界面 的 Activity 中 。 
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Service 是 Android 系统 的 服务 组 件 ,适用 于 开发 没有 用 户 界 面 且 长 时 间 在 后 台 运 行 
的 应 用 功能 。 通 过 本 章 的 学 习 可 以 让 读者 了 解 后 台 服 务 的 基本 原理 ,掌握 本 地 服务 与 远 
程 服务 的 使 用 方法 ,有 助 于 深入 理解 Android 系统 的 进程 间 通 信 机 制 。 

本 章 学 习 目 标 : 

° 了 解 Service 的 原理 和 用 途 ; 

° 掌握 本 地 服务 的 管理 方法 ; 

° 掌握 服务 的 隐 式 启动 和 显 式 启动 方法 ; 

° 了 解 线 程 的 启动 、 挂 起 和 停止 方法 ; 

° 了 解 跨 线程 的 界面 更 新 方法 ; 

。 掌握 远程 服务 的 绑 定 和 调用 方法 ; 

* 了 解 AIDL 语言 的 用 途 和 语法 。 
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因为 手机 硬件 性 能 和 屏幕 尺寸 的 限制 ,通常 Android 系统 仅 允 许 一 个 应 用 程序 处 于 
激活 状态 并 显示 在 手机 屏幕 上 ,而 暂停 其 他 处 于 未 激活 状态 的 程序 。 因 此 ,Android 系统 
pet 一 种 后 台 服 务 机 制 ,允许 在 没有 用 户 界面 的 情况 下 ,使 程序 能 够 长 时 间 在 后 台 运行 ， 

应 用 程序 的 后 台 服 务 功能 ,并 能 够 处 理事 件 或 数据 更 新 。 

Android 系统 提供 的 Service( 服 务 ) 组 件 不 直接 与 用 户 进行 交互 ,能 够 长 期 在 后 台 运 
行 。 在 实际 应 用 中 ,有 很 多 应 用 需要 使 用 Service。 经 常 提 到 的 例子 就 是 MP3 播放 器 , 软 
件 需要 在 关闭 播放 器 界面 后 , 仍 能 够 保持 音乐 持续 播放 ,这 就 需要 在 Service 组 件 中 实现 
音乐 回放 功能 。 

Service 适用 于 无 须 用户 干 预 , 且 规则 或 长 期 运行 的 后 台 功 能 。 首 先 ,因为 Service 没 
有 用 户 界面 ,更 加 有 利于 降低 系统 资源 的 消耗 ,而 且 Service HE Activity 具有 更 高 的 优先 
级 ,因此 在 系统 资源 紧张 时 ,Service 不 会 被 Android 系统 优先 终止 。 即 使 Service 被 系统 
终止 ,在 系统 资源 恢复 后 Service 也 将 自动 恢复 运行 状态 ,因此 可 以 认为 Service 是 在 系 
统 中 永久 运行 的 组 件 。Service 除了 可 以 实现 后 台 服 务 功能 ,还 可 以 用 于 进程 间 通 信 
(Inter Process Communication,IPC) ,解决 不 同 Android 应 用 程序 进程 之 间 的 调用 和 通 
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信和 问题 。 
Service 的 生命 周期 比较 简单 , 仅 包括 完全 生命 周期 和 活动 生命 周期 ,还 有 三 个 事件 
回调 函数 ,分 别 是 onCreateO .onStart() 和 onDestroy() ,如 图 7. 1 所 示 。 


调 А Seri А 
startService() onCreate() | onStart() ooh pg onDestroy() = 关闭 
启动 Service Service 


7.1 Service 生命 周期 


完整 生命 周期 从 onCreate() 开 始 到 onDestroy() 结 束 , 在 onCreate() 中 完成 Service 
的 初始 化 工作 ,在 onDestroy() 中 释放 所 有 占用 的 资源 。 活动 生 命 周期 从 onStart( O F 
始 ,但 没有 与 之 对 应 的 “停止 ”函数 ,因此 可 以 粗略 地 认为 活动 生命 周期 是 以 onDestroy O 
标志 结束 。 

Service 的 使 用 方式 一 般 有 两 种 ,一 种 是 启动 方式 , 另 一 种 是 绑 定 方式 。 在 启动 方式 
中 ,通过 调用 Context. startService O 启动 Service, 通 过 调用 Context. stopService() 或 
Service. stopSelf() 停 止 Service。 因 此 ,Service 一 定 是 由 其 他 的 组 件 启动 的 ,但 停止 过 程 
可 以 通过 其 他 组 件 或 自身 完成 。 

在 启动 方式 中 ,启动 Service 的 组 件 不 能 够 获取 Service 的 对 象 实例 ,因此 无 法 调用 
Service 中 的 任何 函数 ,也 不 能 够 获取 Service 中 的 任何 状态 和 数据 信息 。 能 够 以 启动 方 
式 使 用 的 Service, 需 要 具备 自 管理 的 能 力 .而 且 不 需要 从 通过 函数 调用 获取 Service 的 功 
能 和 数据 。 

在 绑 定 方式 中 ,Service 的 使 用 是 通过 服务 链接 (Connection) 实 现 的 ,服务 链接 能 够 
获取 Service 的 对 象 实例 ,因此 绑 定 Service 的 组 件 可 以 调用 Service 中 实现 的 函数 ,或 直 
接 获 取 Service 中 状态 和 数据 信息 。 使 用 Service 的 组 件 通 过 Context. bindService O ££ 
立 服务 链接 ,通过 Context. unbindService() 停 止 服务 链接 。 如 果 在 绑 定 过 程 中 Service 
没有 启动 ,Context. bindService() 会 自动 启动 Service. 而 且 同 一 个 Service 可 以 绑 定 多 个 
服务 链接 ,这样 可 以 同时 为 多 个 不 同 的 组 件 提供 服务 。 

当然 ,这 两 种 使 用 方法 并 不 是 完全 独立 的 , 某 些 情况 下 可 以 混合 使 用 启动 方式 和 绑 
定 方式 。 还 是 以 MP3 播放 器 为 例 , 在 后 台 的 工作 的 Service 通过 Context. startServiceC) 
启动 某 个 音乐 播放 ,但 在 播放 过 程 中 如 果 用 户 需 要 暂停 音乐 播放 , 则 要 通过 Context. 
bindService() 获 取 服 务 链接 和 Service 对 象 实例 ,进而 通过 调用 Service 对 象 实例 中 的 函 
数 ,暂停 音乐 播放 过 程 ,并 保存 相关 信息 。 在 这 种 情况 下 ,如 果 调 用 Context. stopService() 
并 不 能 够 停止 Service, 需 要 在 所 有 的 服务 链接 关闭 后 ,Service 才能 够 真正 停止 。 
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721 服务 管理 
服务 管理 主要 指 服务 的 启动 和 停止 。 在 介绍 如 何 启动 和 停止 服务 前 ,首先 说 明 如 何 


在 代码 中 实现 Service. Service 是 一 段 在 后 台 运 行 .没有 用 户 界 面 的 代码 ,其 最 小 代码 集 


如 下 。 


о © - O 0 > шю н 


в 
о 


z@= 后 台 服 务 
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import android.app.Service; 


import android.content.Intent; 
import android.os.IBinder; 


public class RandomService extends Service ( 


) 


@ Override 
public IBinder onBind (Intent intent) { 
return null; 


} 


在 上 面 的 代码 中 ,除了 在 第 1 行 到 第 3 行 引 入 必要 包 外 , 仅 在 第 5 行 声明 了 
RandomService 继承 android. app. Service 类 ,在 第 7 行 到 第 9 行 重 载 了 onBind() 函数 。 


onBind O 函数 是 在 Service 被 绑 定 后 调用 的 函数 ,能 够 返回 Service 的 对 象 实例 ,在 后 面 


的 内 容 中 会 有 详细 的 介绍 。 


这 个 Service 最 小 代码 集 并 没有 任何 实际 的 功能 。 为 了 使 Service 具有 实际 意义 ,一 
般 需要 重 载 onCreate()、onStart() 和 onDestroy()。Android 系统 在 创建 Service 时 ,会 


自动 调用 onCreateO ,用 户 一 般 在 onCreate() 完 成 必要 的 初始 化 工作 ,例如 创建 线程 、 建 
立 数据 库 链 接 等 。 在 Service 关闭 前 ,系统 会 自动 调用 onDestroy O 函数 释放 所 有 占用 的 
资源 。 通 过 Context. startService(Intent) 启 动 Service,onStart() 则 会 被 调用 ,重要 的 参 
数 通 过 参数 Intent 传递 给 Service。 当 然 ,不 是 所 有 的 Service 都 需要 重 载 这 三 个 函数 ,可 
以 根据 实际 情况 选择 需要 重 载 的 函数 。 


З 
2 
З 
4 
5 
6 
7 
8 
9 


10 
11 
12 
13 
14 


public class RandomService extends Service( 


} 


@Override 
public void onCreate () { 
super.onCreate (); 
} 
@Override 
public void onStart (Intent intent, int startId) { 
super.onStart (intent, startId); 
} 
@ Оуеггіае 
public void onDestroy () { 
super.onDestroy(); 
} 


重 载 onCreate() .onStart() 和 onDestroy O = 4 8. ЛЕ НН А] 30 РАЖ. 
如 代码 的 第 4 行 .第 8 行 和 第 12 行 。 
完成 Service 类 后 .需要 在 AndroidManifest. xml 文件 中 注册 这 个 Service。 注 册 
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Service 非常 重要 ,如 果 开 发 人 员 不 对 Service 进行 注册 , 则 Service 根本 无 法 启动 。 
AndroidManifest. xml 文件 中 注册 Service 的 代码 如 下 。 


1 «service android:name- ".RandomService"/» 


fili А < service bi 4 75 HH 2, Ж) android: name 表示 Service 类 的 名 称 ,一 定 要 
与 建立 的 Service 类 名 称 一 致 。 

在 完成 Service 代码 和 在 AndroidManifest. xml 文件 中 注册 后 ,下面 来 说 明 如 何 启 动 
和 停止 Service。 有 两 种 方法 启动 Service, 显 式 启 动 和 隐 式 启动 。 显 式 启动 需要 在 Intent 
中 指明 Service 所 在 的 类 ,并 调用 startService(Intent) 启 动 Service, 示 例 代 码 如 下 。 


1 final Intent serviceIntent=new Intent (this, RandomService.class); 


2 startService (serviceIntent); 


在 上 面 的 代码 中 ,Intent 指明 了 启动 的 Service 所 在 类 为 RandomService, 
隐 式 启动 则 需要 在 注册 Service 时 ,声明 Intent-filter 的 action 属性 。 


< service android:name- " .RandomService"> 


«intent- filter» 


1 
2 
3 «action android:name- "edu.hrbeu.RandomService" /» 
4 < /intent- filter» 

5 


< /service» 


在 隐 式 启动 Service 时 ,需要 设置 Intent 的 action 属性 ,这样 则 可 以 在 不 声明 Service 
所 在 类 的 情况 下 启动 服务 。 隐 式 启动 的 代码 如 下 。 


final Intent serviceIntent=new Intent (); 


2  serviceIntent.setAction ("edu.hrbeu.RandomService") ; 


如 果 Service 和 调用 服务 的 组 件 在 同一 个 应 用 程序 中 ,可 以 使 用 显 式 启动 或 隐 式 启 
动 , 显 式 启动 更 加 易于 使 用 , 且 代 码 简洁 。 但 如 果 服 务 和 调用 服务 的 组 件 在 不 同 的 应 用 
程序 中 , 则 只 能 使 用 隐 式 启动 。 

无 论 是 显 式 启动 还 是 隐 式 启动 ,停止 Service 的 方法 都 是 相同 的 ,将 启动 Service 的 
Intent 传递 给 stopService(Intent) 函 数 即 可 ,示例 代码 如 下 。 


T stopService (serviceIntent); 


在 首次 调用 startServiceCIntent) 函数 启动 Service 后 ,系统 会 先后 调用 onCreate OO 1 
ongStart() 。 如 果 是 第 二 次 调用 startService(Intent) 函数 ,系统 则 仅 调 用 onStart() ,而 不 
再 调用 onCreate ( ) 。 在 调用 stopService (Intent) 函数 停止 Service 时 ,系统 会 调用 
onDestroyO 。 无 论调 用 过 多 少 次 startService(Intent) ,在 调用 stopServiceCIntent) 函数 
时 ,系统 仅 调用 一 次 onDestroy() 。 

SimpleRandomServiceDemo 是 在 应 用 程序 中 使 用 Service 的 示例 ,这 个 示例 使 用 显 
式 启动 的 方式 启动 Service。 在 工程 中 创建 了 RandomService 服务 ,该 服务 启动 后 会 产生 
一 个 随机 数 , 并 使 用 Toast 显示 在 屏幕 上 ,如 图 7.2 所 示 。 
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9..0 11:05 


SimpleRandomServiceDemo 


启动 SERVICE 


停止 SERVICE 


随机 数 : 0.6557307470247945 


7.2 SimpleRandomServiceDemo 用 户 界 面 


通过 界面 上 的 “启动 SERVICE” 按钮 调用 startService(Intent) 函数 ,启动 RandomService 


服务 。* 


HIE SERVICE” 按 钮 调用 stopServiceCInten) PR Zt. 16 RandomService 服务 。 为 了 


能 够 清晰 地 观察 Service 中 onCreate() .onStart() 和 onDestroy() 三 个 函数 的 调用 顺序 ,在 每 
个 函数 都 中 使 用 Toast 在 界面 上 产生 提示 信息 。 
RandomService. java 文件 的 代码 如 下 。 


1 


N 


package edu.hrbeu.SimpleRandomServiceDemo; 


import android.app.Service; 
import android.content.Intent; 


import android.os.IBinder; 
import android.widget.Toast; 


public class RandomService extends Service{ 


@ Override 
public void onCreate () { 
super.onCreate (); 
Toast .makeText (this, "(1) 调 用 опСгеасе()", 


Toast .LENGTH LONG) .show () ; 


@ Override 


public void onStart (Intent intent, int startId){ 


166 


CA зж) 


super.onStart (intent, startId); 
Toast .makeText (this, "(2) 调 用 onstart O", 
Toast .LENGTH SHORT) . show () ; 


double randomDouble=Math.random () ; 
String msg- "随机 数 :"+ String.valueOf (randomDouble); 
Toast.makeText (this,msg, Toast.LENGTH SHORT).show(); 


@override 
public void onDestroy () ( 
super.onDestroy () ; 
Toast .makeText (this, "(3) 调 用 onbestroy Q ", 
Toast.LENGTH SHORT) . show () ; 


@ Override 
public IBinder onBind (Intent intent) { 


return null; 


} 


在 onStart() 函 数 中 添加 生产 随机 数 的 代码 ,第 23 行 生 产 一 个 介 于 0 和 1 之 间 的 随 
机 数 ,并 在 第 24 行 构造 供 Toast 显示 的 消息 。 
AndroidManifest. xml 文件 的 代码 如 下 。 


E 
2 
3 
4 
5 
6 


<?xml version- "1.0" encoding- "utf- 8"?» 

«manifest xmlns:android- "http://schemas.android.com/apk/res/android" 
package- "edu.hrbeu.SimpleRandomServiceDemo" 
android:versionCode- "1" 


android:versionName- "1.0"> 


«application android:icon- "6 drawable/icon" 
android:label- "@ string/app name" 
«activity android:name- ".SimpleRandomServiceDemo" 
android:label- "@ string/app name" 
«intent-filter^ 
« action android:name- "android.intent.action.MAIN" /» 
«category android:name- "android.intent.category.LAUNCHER" /> 
< /intent- filter» 
< activity» 
« service android:name- ".RandomService"/» 
« /application» 
«uses- sdk android:minSdkVersion- "14" /> 


< /manifest» 
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在 调用 AndroidManifest. xml 文件 中 . fE— application T4 F ,包含 一 个 二 activity 之 标 
/&FI— 4 — service В, Е — service bj E P IH RandomService 所 在 的 类 。 
SimpleRandomServiceDemoActivity. java 文件 的 代码 如 下 。 


package edu.hrbeu.SimpleRandomServiceDemo; 


import android.app.Activity; 
import android.content.Intent; 


import android.view.View; 


£ 
2 
3 
4 
5 import android.os.Bundle; 
6 
7 import android.widget.Button; 
8 
9 


public class SimpleRandomServiceDemoActivity extends Activity { 


10 @override 

11 public void onCreate (Bundle savedInstanceState)( 

12 super.onCreate (savedInstanceState); 

13 setContentView (R.layout.main); 

14 

15 Button startButton- (Button) findViewById (R.id.start); 

16 Button stopButton- (Button) findViewById (R.id.stop); 

AT final Intent serviceIntent=new Intent (this, RandomService.class); 
18 startButton.setOnClickListener (new Button.OnClickListener () ( 
19 public void onClick (View уіем) { 

20 startService (serviceIntent); 

21 } 

22 n; 

23 stopButton.setOnClickListener (new Button.OnClickListener () ( 
24 public void onClick (View view) { 

25 stopService (serviceIntent); 

26 ) 

27 n; 

28 } 

29 } 


SimpleRandomServiceDemoActivity. Java 文件 是 应 用 程序 中 的 Activity 代码 ,第 20 
行 和 第 25 行 分 别 是 启动 和 停止 Service 的 代码 。 

这 里 不 再 给 出 隐 式 启动 Service 的 示例 代码 ,如 需要 请 参考 ImplicityRandomServiceDemo 
示例 。 


722 使 用 线程 


在 Android 系统 中 ,Activity、Service 和 BroadcastReceiver 都 是 工作 在 主线 程 上 , 因 
此 任何 耗 时 的 处 理 过 程 都 会 降低 用 户 界 面 的 响应 速度 ,甚至 导致 用 户 界面 失去 响应 。 当 
用 户 界 面 失去 响应 超过 5 秒 后 , Android 系统 会 允许 用 户 强 行 关闭 应 用 程序 ,提示 如 
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图 7. з 所 示 。 因 此 , 较 好 的 解决 方法 是 将 耗 时 的 处 理 过 ESD 
程 转移 到 子 线程 上 ,这 样 可 以 缩短 主线 程 的 事件 处 理 时 is not responding. Would you 
间 , 从 而 避免 用 户 界面 长 时 间 失 去 响应 。“ 耗 时 的 处 理 КАЛАШ 
过 程 "一 般 指 复杂 运算 过 程 , 大 量 的 文件 操作 、 存 在 延 时 Ы 
的 网 络 通信 和 数据 库 操作 等 。 

线程 是 独立 的 程序 单元 ,多 个 线程 可 以 并 行 工 作 。 
在 多 处 理 器 系统 中 ,每 个 中 央 处 理 器 (CPU) 单 独 运行 一 个 线程 ,因此 线程 是 并 行 工 作 的 。 
但 在 单 处 理 器 系统 中 ,处理 器 会 给 每 个 线程 一 小 段 时 间 ,在 这 个 时 间 内 执行 该 线程 ,然后 
处 理 器 执行 下 一 个 线程 ,这样 就 产生 了 线程 并 行 运行 的 假象 。 无 论 线程 是 否 真 地 并 行 工 
TE ,在 宏观 上 可 以 认为 子 线程 是 独立 于 主线 程 , 且 能 与 主线 程 并 行 工作 的 程序 单元 。 

在 Java 语言 中 ,建立 和 使 用 线程 比较 简单 ,首先 需要 实现 Java 的 Runnable 接口 ,并 
重 载 run O PRÉC YE run() 中 放置 代码 的 主体 部 分 。 


图 7.3 失去 响应 时 的 提示 信息 


1 private Runnable backgroudWork=new Runnable () ( 
2 @override 

3 public void run () ( 

4 // 过 程 代 码 
5 

6 


} 
н 
然后 创建 Thread 对 象 ,并 将 Runnable 对 象 作 为 参数 传递 给 Thread 对 象 。 在 
Thread 的 构造 函数 中 ,第 1 个 参数 用 来 表示 线程 组 ,第 2 个 参数 是 需要 执行 的 Runnable 
对 象 ,第 3 个 参数 是 线程 的 名 称 。 
1 private Thread workThread; 
2 workThread- new Thread (null,backgroudWork, "WorkThread"); 


最 后 ,调用 start() 方 法 启动 线程 。 
1  workThread.start(); 


当 线 程 在 run() 方 法 返回 后 ,线程 就 自动 终止 了 。 当 然 , 也 可 以 调用 stop() 在 外 部 终 
止 线程 。 但 不 推荐 使 用 这 种 方法 ,因为 该 方法 并 不 安全 ,有 可 能 产生 异常 。 最 好 的 方法 
是 通知 线程 自行 终止 ,一 般 调用 interrupt() 方 法 通告 线程 准备 终止 ,线程 会 释放 它 正在 
使 用 的 资源 ,在 完成 所 有 的 清理 工作 后 自行 关闭 。 


x workThread.interrupt (); 


其 实 interrupt() 方 法 并 不 能 直接 终止 线程 , 仅 是 改变 了 线程 内 部 的 一 个 布尔 值 ,run() 
方法 能 够 检测 到 这 个 布尔 值 的 改变 ,从 而 在 适当 的 时 候 释 放 资 源 和 终止 线程 。 在 run() 
中 的 代码 一 般 通 过 Thread. interrupted() 方 法 查询 线程 是 否 被 中 断 。 一 般 情况 下 , 子 线 
程 需要 无 限 运行 ,除非 外 部 调用 interrupt() 方 法 中 断 线程 ,所 以 通常 会 将 程序 主体 放置 
在 whileO р P] ,并 调用 Thread. interrupted() 方 法 判断 线程 是 否 应 被 中 断 。 下 面 的 代 
码 中 ,以 1 秒 为 间隔 循环 检测 线程 是 否 应 被 中 断 。 
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1 public void run(){ 

2 while (!Thread.interrupted|())( 
3 // 过 程 代码 

4 Thread.sleep (1000); 
5 

6 


) 


第 4 行 代码 使 线程 休眠 1000 毫秒 。 当 线程 在 休眠 过 程 中 线程 被 中 断 , 则 会 产生 
InterruptedException 异常 。 在 中 断 的 线程 上 调用 sleep() 方法 ,同样 会 产生 
InterruptedException 异常 。 因 此 代码 中 需要 捕获 InterruptedException 异常 ,保证 安全 
终止 线程 。 


public void run () ( 
try { 
while (true)( 
// 过 程 代 码 
Thread.sleep (1000); 


) catch (InterruptedException е) { 
e.printStackTrace () ; 


T 

1 

2 

3 

4 

5 } 
6 

7 

8 } 
9 


} 


到 这 里 读者 已 经 可 以 设计 自己 的 线程 ,但 还 存在 一 个 不 可 回避 的 问题 ,如 何 使 用 线 
程 中 的 数据 更 新 用 户 界 面 。Android 系统 提供 了 多 种 方法 解决 这 个 问题 ,这 里 仅 介 绍 使 
用 Handler 更 新 用 户 界面 的 方法 。 

Handler 允许 将 Runnable 对 象 发 送 到 线程 的 消息 队列 中 ,每 个 Handler 实例 绑 定 到 
一 个 单独 的 线程 和 消息 队列 上 。 当 用 户 建立 一 个 新 的 Handler 实例 ,通过 post() 方 法 将 
Runnable 对 象 从 后 台 线 程 发 送 给 GUI 线程 的 消息 队列 , 当 Runnable 对 象 通过 消息 队列 
后 ,这 个 Runnable 对 象 将 被 运行 。 


E d private static Handler handler- new Handler () ; 

3 public static void UpdateGUI (double refreshDouble)( 
4 handler.post (RefreshLable); 

5 } 

6 private static Runnable RefreshLable- new Runnable () { 
4 @ Override 

8 public void run () { 

9 // 过 程 代码 

10 } 

t- -$ 


在 上 面 的 代码 中 ,第 1 行 建立 了 一 个 静态 的 Handler 实例 ,但 这 个 实例 是 私有 的 , 因 
此 外 部 代码 并 不 能 直接 调用 这 个 Handler 实例 。 第 3 17 UpdateGUI(C) 是 公有 的 界面 更 
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新 函数 ,后 台 线 程 通过 调用 该 函数 ,将 后 台 产 生 的 数据 refreshDouble 传递 到 UpdateGUIO 
函数 内 部 ,然后 直接 调用 post() 方 法 ,将 第 6 行 创建 的 Runnable 对 象 传递 给 界面 线程 
(主线 程 ) 的 消息 队列 中 。 第 8 行 到 第 10 行 代码 是 Runnable 对 象 中 需要 重 载 的 run O PR 
数 ,界面 更 新 代码 就 在 这 里 

ThreadRandomServiceDemo 是 使 用 线程 持续 产生 随机 数 的 示例 。 点 击 “ 启 动 
Service” 后 将 启动 后 台 线 程 ,点 击 “ 停 止 Service” 将 关闭 后 台 线程 。 后 台 线 程 每 1 秒 钟 产 
生 一 个 0 到 1 之 间 的 随机 数 ,并 通过 Handler 将 产生 的 随机 数 显 示 在 用 户 界面 上 。 
ThreadRandomServiceDemo 的 用 户 界面 如 图 7.4 所 示 。 
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ThreadRandomServiceDemo 


启动 SERVICE 


停止 SERVICE 


7.4 ThreadRandomServiceDemo 用 户 界 面 


ТЕ ThreadRandomServiceDemo 示例 中 ,RandomService. java 文件 是 定义 Service 的 文件 ， 
用 来 创建 线程 ,产生 随机 数 和 调用 界面 更 新 函数 。ThreadRandomServiceDemoActivity. java 
文件 是 用 户 界 面 的 Activity 文件 ,封装 Handler 界面 更 新 的 函数 就 在 这 个 文件 中 。 下 面 给 
出 RandomService. java 和 ThreadRandomServiceDemoActivity. java 文件 的 完整 代码 。 
RandomService. java 文件 的 完整 代码 如 下 。 


package edu.hrbeu.ThreadRandomServiceDemo; 


import android.app.Service; 
import android.content.Intent; 


import android.widget.Toast; 


a 
3 
4 
5 import android.os.IBinder; 
6 
7 
8 public class RandomService extends Service( 
9 


10 private Thread workThread; 

ат 

12 @ Override 

13 public void onCreate () { 

14 super.onCreate(); 

15 Toast.makeText (this, "(1) 调 用 опСгеасе()", 
16 Toast.LENGTH IONG) .show () ; 


AT workThread- new Thread (null,backgroudWork, "WorkThread"); 


57 


} 
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@Override 
public void onStart (Intent intent, int startId)( 
super.onStart (intent, startId); 
Toast.makeText (this, "(2) 调 用 onstart Q ", 
Toast.LENGTH SHORT).show(); 
if (!workThread.isAlive ()) ( 
workThread.start(); 


@ Override 
public void onDestroy () ( 
super.onDestroy () ; 
Toast.makeText (this, " (3) 调用 onDestroy () ", 
Toast.LENGTH SHORT) . show () ; 
workThread.interrupt () ; 


@ Override 
public IBinder onBind (Intent intent) { 


return null; 


private Runnable backgroudWork- new Runnable () { 
@ Override 
public void run () ( 
try { 
while (!Thread.interrupted())( 
double randomDouble- Math.random(); 
ThreadRandomServiceDemoActivity .UpdateGUI (randomDouble) ; 
Thread.s1leep (1000); 
} 
) catch (InterruptedException е) { 
e.printStackTrace (); 


}: 


ThreadRandomServiceDemoActivity. java 文件 的 完整 代码 如 下 。 


£ 
2 


package edu.hrbeu.ThreadRandomServiceDemo; 
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import android.app.Activity; 
import android.content.Intent; 
import android.os.Bundle; 


import android.view.View; 


3 

4 

5 

6 import android.os.Handler; 

7 

8 import android.widget.Button; 
9 


import android.widget.TextView; 


11 public class ThreadRandomServiceDemoActivity extends Activity ( 


13 private static Handler handler- new Handler (); 

14 private static TextView labelView-null; 

15 private static double randomDouble; 

16 

17 public static void UpdateGUI (double refreshDouble) { 

18 randomDouble- refreshDouble; 

19 handler.post (RefreshLable); 

20 } 

21 

22 private static Runnable RefreshLable- new Runnable () { 

23 @ Override 

24 public void run () { 

25 labelView.setText (String.valueOf (randomDouble)); 
26 } 

27 J 

28 

29 @ Override 

30 public void onCreate (Bundle savedInstanceState) { 

31 super.onCreate (savedInstanceState); 

32 setContentView (R.layout.main); 

33 labelView- (TextView)findViewById (R.id.label); 

34 Button startButton- (Button) findViewById (R.id.start); 
35 Button stopButton- (Button) findViewById (R.id.stop); 
36 final Intent serviceIntent- new Intent (this, RandomService.class); 
37 

38 startButton.setOnClickListener (new Button.OnClickListener () ( 
39 public void onClick (View view) { 

40 startService (serviceIntent); 

41 } 

42 n; 

43 

44 stopButton.setOnClickListener (new Button.OnClickListener () { 
45 public void onClick (View view) { 


46 StopService (serviceIntent); 
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47 } 
48 р; 
49 } 

50 } 


723 服务 绑 定 


以 绑 定 方式 使 用 Service ,能够 获取 Service 实例 ,不 仅 能 够 正常 启动 Service, 还 能 够 
调用 Service 中 的 公有 方法 和 属性 。 为 了 使 Service 支持 绑 定 ,需要 在 Service 类 中 重 载 
onBind() 方 法 ,并 在 onBind() 方 法 中 返回 Service 实例 ,示例 代码 如 下 。 


1 public class MathService extends Service( 

2 private final IBinder mBinder- new LocalBinder (); 
3 

4 public class LocalBinder extends Binder( 
5 MathService getService|()( 

6 return MathService.this; 

7 } 

8 } 

9 

10 @ Override 

11 public IBinder onBind (Intent intent) { 

12 return mBinder; 

13 } 

14 } 


M Service 被 绑 定 时 ,系统 会 调用 onBind O A Zt. š Ë onBind O PR fc 25 [n] (ei «df 
Service 实例 返回 给 调用 者 。 从 第 11 行 代码 中 可 以 看 出 ,onBind() 函 数 的 返回 值 必须 符 
£ IBinder 接口 ,因此 在 代码 的 第 2 行 声 明 一 个 接口 变量 mBinder。mBinder 符合 onBind() 
函数 返回 值 的 要 求 ,因此 可 将 mBinder 传递 给 调用 者 。IBinder 是 用 于 进程 内 部 和 进程 
间 过 程 调用 的 轻 量 级 接口 ,定义 了 与 远程 对 象 交互 的 抽象 协议 ,使 用 时 通过 继承 Binder 
的 方法 实现 。 继 承 Binder 的 代码 在 第 4 行 ,LocalBinder 是 继承 Binder 的 一 个 内 部 类 ,并 
在 代码 第 5 行 实现 了 getService() 函 数 , 当 调用 者 获取 mBinder 后 ,通过 调用 getService() 即 
可 获取 Service 实例 。 

调用 者 通过 bindService O 函数 绑 定 服务 ,并 在 第 1 个 参数 中 将 Intent 传递 给 
bindServiceC) 函数 ,声明 需要 启动 的 Service。 第 3 个 参数 Context. BIND_AUTO _ 
CREATE 表明 只 要 绑 定 存在 ,就 自动 建立 Service; 同时 也 告知 Android 系统 ,这 个 
Service 的 重要 程度 与 调用 者 相同 .除非 考虑 终止 调用 者 ,否则 不 要 关闭 这 个 Service。 


1 final Intent serviceIntent=new Intent (this,MathService.class); 


2  bindService (serviceIntent,mConnection,Context.BIND AUTO CREATE); 


bindService O 函数 的 第 2 个 参数 是 ServiceConnnection。 当 绑 定 成 功 后 ,系统 将 调 
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用 ServiceConnnection 的 onServiceConnected() 方 法 :而 当 绑 定 意外 断 开 后 ,系统 将 调用 
ServiceConnnection 中 的 onServiceDisconnected 方法 。 因 此 ,以 绑 定 方式 使 用 Service， 
调用 者 需要 声明 一 个 ServiceConnnection ,并 重 载 内 部 的 onServiceConnected() 方 法 和 
onServiceDisconnected 方法 ,两 个 方法 的 重 载 代码 如 下 。 


private ServiceConnection mConnection- new ServiceConnection(){ 

@ Override 

public void onServiceConnected (ComponentName name, IBinder service) { 
mathService- ((MathService.LocalBinder)service) .getService (); 


@ Оуеггіде 
public void onServiceDisconnected (ComponentName папе) { 


T 

2 

3 

4 

5 } 
6 

Y 

8 mathService-null; 
9 


H 

10 н; 

在 代码 的 第 4 行 中 , 绑 定 成 功 后 通过 getService() 获 取 Service 实例 ,这 样 便 可 以 调 
用 Service 中 的 方法 和 属性 。 代 码 第 8 行将 Service 实例 指 为 null, 表 示 绑 定 意外 失效 时 ， 
Service 实例 不 再 可 以 。 

取消 绑 定 仅 需 要 使 用 unbindService ( ) 方 法 ,并 将 ServiceConnnection 传递 给 
unbindService() 方 法 。 但 需要 注意 的 是 ,unbindService( ) 方 法 成 功 后 ,系统 并 不 会 调用 
onServiceConnected() ,因为 onServiceConnected() 仅 在 意外 断 开 绑 定时 才 被 调用 。 


1  unbindService (mConnection); 


绑 定 方式 中 , 当 调 用 者 通过 bindService O ER ZI Jf E Service 时 ,onCreate() 函数 和 
onBinde() 函 数 将 被 先后 调用 。 当 调用 者 通过 unbindService() 函 数 取 消 绑 定 Service 时 ， 
onUnbind() 函 数 将 被 调用 。 如 果 onUnbind() 函 数 返 回 true, 则 表示 重新 绑 定 服 务 时 ， 
onRebind() 函 数 将 被 调用 。 绑 定 方式 的 函数 调用 顺序 如 图 7. 5 所 示 。 


调用 客户 端 与 


bindService() onCreate() =| onBind() Service onUnbind() | onDestory() 停止 
启动 Service 交互 | Service 
onRebind() 


图 7.5 绑 定 方式 的 函数 调用 顺序 


SimpleMathServiceDemo 是 绑 定 方式 使 用 Service 的 示例 。 在 示例 中 创建 了 
MathService 服务 ,用 来 完成 简单 的 数学 运算 。 这 里 的 数学 运算 仅 指 加 法 运算 ,虽然 没有 
实际 意义 ,但 可 以 说 明 如 何 使 用 绑 定 方式 调用 Service 中 的 公有 方法 。 在 服务 绑 定 后 ,用 
户 可 以 点 击 “ 加 法 运算 ”按钮 ,将 两 个 随机 产生 的 数值 传递 给 MathService 服务 ,并 从 
MathService 实例 中 获取 加 法 运算 的 结果 ,然后 显示 在 屏幕 的 上 方 .“ 取 消 绑 定 ?按钮 可 
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以 解除 与 MathService 的 绑 定 关系 ,在 取消 绑 
定 后 ,点 击 “ 加 法 运算 ”按钮 将 无 法 获取 运算 结 
果 。SimpleMathServiceDemo 的 用 户 界 面 如 
图 7.6 所 示 。 

TE SimpleMathServiceDemo 示例 中 ， 
MathService. java 文件 是 Service 的 定义 文 
件 。SimpleMathServiceDemoActivity. java Ж 
件 是 界面 的 Activity 文件 , 绑 定 服务 和 取消 绑 


SimpleMathServiceDemo 


PT 01170 


定 服 务 的 代码 在 这 个 文件 中 。 下 面 给 出 图 7.6 SimpleMathServiceDemo 用 户 界面 


MathService. java 和 SimpleMathServiceDe- 
moActivity. java 文件 的 完整 代码 。 
MathService. java 文件 的 完整 代码 如 下 。 


1 package edu.hrbeu.SimpleMathServiceDemo; 
3 import android.app.Service; 

4 import android.content.Intent; 

5 import android.os.Binder; 

6 import android.os.IBinder; 

7 import android.widget.Toast; 

8 
B 


public class MathService extends Service { 


10 

11 private final IBinder mBinder- new LocalBinder () ; 
12 

13 public class LocalBinder extends Binder( 

14 MathService getService|()í 

15 return MathService.this; 

16 } 

17 } 

18 

19 @ Override 

20 public IBinder onBind (Intent intent) { 

21 Toast.makeText (this，" 本 地 绑 定 :MathService", 
22 Toast.LENGTH SHORT) . show () ; 

23 return mBinder; 

24 } 

25 

26 @ Override 

27 public boolean onUnbind (Intent intent) { 

28 Toast.makeText (this，" 取 消 本 地 绑 定 :Mathnservice", 
29 Toast.LENGTH SHORT).show(); 


30 return false; 
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34 public long Add (long a, long b)( 


35 return atb; 


38 ) 
SimpleMathServiceDemoA ctivity. java 文件 的 完整 代码 如 下 。 


package edu.hrbeu.SimpleMathServiceDemo; 


import android.app.Activity; 
import android.content .ComponentName; 


1 
2 
3 
4 
5 import android.content.Context; 
6 import android.content.Intent; 

7 import android.content.ServiceConnection; 
8 import android.os.Bundle; 

9 import android.os.IBinder; 

10 import android.view.View; 

11 import android.widget.Button; 


12 import android.widget.TextView; 


14 public class SimpleMathServiceDemoActivity extends Activity { 


15 private MathService mathService; 

16 private boolean isBound= false; 

£? TextView labelView; 

18 @override 

19 public void onCreate (Bundle savedInstanceState) { 

20 super.onCreate (savedInstanceState); 

21 setContentView (R.layout.main); 

22 

23 labelView- (TextView)findViewById (R.id.label); 

24 Button bindButton- (Button) findViewById (R.id.bind); 

25 Button unbindButton- (Button) findViewById (R.id.unbind); 

26 Button computButton- (Button) findViewById (R.id.compute); 
27 

28 bindButton.setOnClickListener (new View.OnClickListener () { 
29 @ Override 

30 public void onClick (View у) { 

31 if (!isBound)( 

32 final Intent servicelIntent - new Intent 


(SimpleMathServiceDemoActivity.this,MathService.class); 


33 bindService (serviceIntent,mConnection,Context.BIND AUTO CREATE); 
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isBound-true; 


n; 


unbindButton.setOnClickListener (new View.OnClickListener () { 
@ Override 
public void onClick (View v) ( 
if (isBound)( 
isBound- false; 
unbindService (mConnection); 


mathService-null; 


computButton.setOnClickListener (new View.OnClickListener () { 
QOverride 
public void onClick (View v) ( 
if (mathService- = пи11) { 
labelView.setText (" 未 绑 定 服务 "); 
return; 
) 
long a=Math.round (Math.random() * 100); 
long b=Math. round (Math.random() * 100); 
long result-mathService.Add (а, b); 
String msg-String.valueOf (а) + "+ "+ String.valueOf (р) + 
"—'-String.valueOf (result); 
labelView.setText (msg); 


private ServiceConnection mConnection- new ЅегуісеСоппесііоп () { 
@ Override 
public void onServiceConnected (ComponentName name, IBinder ѕегуісе) { 
mathService- ((MathService.LocalBinder)service) .getService(); 


@ Override 
public void onServiceDisconnected (ComponentName name) { 
mathService- null; 
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731 进程 间 通 信 


在 Android 系统 中 ,每 个 应 用 程序 在 各 自 的 进程 中 运行 ,而 且 出 于 安全 原因 的 考虑 ， 
这 些 进程 之 间 彼 此 是 隔离 的 。 进 程 之 间 传 递 数据 和 对 象 ,需要 使 用 Android 支持 的 进程 
间 通 信 (Inter-Process Communication, IPC) 机制 。 在 Unix/Linux 系统 中 ,传统 的 IPC 
机 制 包 括 共 享 内 存 .管道 .消息 队列 和 socket 等 ,这 些 IPC 机 制 虽 然 被 广泛 使 用 ,但 仍然 
存在 着 固有 的 缺陷 ,如 容易 产生 错误 、 难 于 维护 等 。 在 Android 系统 中 ,没有 使 用 传统 的 
IPC 机 制 ,而 是 采用 Intent 和 远程 服务 的 方式 实现 IPC, 使 应 用 程序 具有 更 好 的 独立 性 和 
鲁 棒 性 。 

Android 系统 允许 应 用 程序 使 用 Intent 使 用 其 他 Activity 和 Service, 同 时 Intent 可 
以 承载 数据 ,这 是 一 种 极为 简单 、 高 效 , 且 易 于 使 用 的 IPC 机 制 。Android 系统 的 另 一 种 
IPC 机 制 就 是 远程 服务 ,服务 和 调用 者 在 不 同 的 两 个 进程 中 ,调用 过 程 需 要 跨越 进程 才 
能 实现 。 

在 Android 系统 中 使 用 远程 服务 ,一 般 按照 以 下 三 个 步骤 实现 。 首 先 ,使 用 AIDL 
语言 定义 远程 服务 的 接口 。 然 后 根据 AIDL 语言 定义 的 接口 ,在 具体 的 Service 类 中 实 
现 接口 中 定义 的 方法 和 属性 。 最 后 在 需要 调用 远程 服务 的 组 件 中 ,通过 相同 的 AIDL 接 
口 文件 ,调用 远程 服务 。 


7.32 服务 创建 与 调用 


在 Android 系统 中 ,进程 之 间 不 能 直接 访问 对 方 的 内 存 空间 ,因此 为 了 使 数据 能 够 
在 不 同 进程 间 传 递 ,数据 必须 转换 成 能 够 穿越 进程 边界 的 系统 级 原 语 , 同 时 ,在 数据 完成 
进程 边界 穿越 后 ,还 需要 转换 回 原 有 的 格式 。 

AIDL(Android Interface Definition Language) 是 Android 系统 自 定义 的 接口 描述 
语言 ,可 以 简化 进程 间 数 据 格式 转换 和 数据 交换 的 代码 ,通过 定义 Service 内 部 的 公共 方 
法 ,允许 在 不 同 进程 间 的 调用 者 和 Service 之 间 相 互 传递 数据 。AIDL 的 IPC 机 制 .COM 
和 Corba 都 是 基于 接口 的 轻 量 级 进程 通信 机 制 。 

AIDL 语言 的 语法 与 Java 语言 的 接口 定义 非常 相似 ,唯一 不 同 之 处 在 于 ,AIDL 允许 
定义 函数 参数 的 传递 方向 。AIDL 支持 三 种 方向 : in out 和 inout, 标 识 为 in 的 参数 将 从 
调用 者 传递 到 远程 服务 中 ,标识 为 out 的 参数 将 从 远程 服务 传递 到 调用 者 中 ,标识 为 
inout 的 参数 将 先 从 调用 者 传递 到 远程 服务 中 ,再 从 远程 服务 返回 给 调用 者 。 如 果 不 标 
识 参数 的 传递 方向 ,默认 所 有 函数 的 传递 方向 为 in。 出 于 性 能 方面 的 考虑 ,不 要 在 参数 
中 标识 不 需要 的 传递 方向 。 

远程 服务 的 创建 和 调用 需要 使 用 AIDL 语言 ,一 般 分 为 以 下 三 个 过 程 ， 
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CD 使 用 AIDL 语言 定义 远程 服务 的 接口 ; 

(2) 通过 继承 Service 类 实现 远程 服务 s 

(3) 绑 定 和 使 用 远程 服务 。 

下 面 以 RemoteMathServiceDemo 示例 为 参考 ,说 明 如 何 创建 远程 服务 。 在 这 个 示 
例 中 定义 了 MathService 服务 ,可 以 为 远程 调用 者 提供 加 法 服务 。 


1. 使 用 AIDL 语言 定义 远程 服务 的 接口 


首先 使 用 AIDL 语言 定义 MathService 的 服务 接口 ,服务 接口 文件 的 扩展 名 为 . aidl， 
使 用 的 包 名 称 与 Android 项 目 所 使 用 的 相同 。 在 src 目录 下 建立 IMathService. aidl X 
件 , 代 码 如 下 。 


1 package edu.hrbeu.RemoteMathServiceDemo; 
2 interface IMathService { 

а long Add (long a, long b); 

a d 

从 上 面 的 代码 中 可 以 看 出 ,IMathService 接口 仅 包含 一 个 add() 方 法 ,传人 的 参数 是 
两 个 长 型 整数 ,返回 值 也 是 长 型 整数 。 

使 用 Eclipse 编辑 IMathService. aidl 文件 , 当 保 存 文件 后 Eclipse 的 ADT 插件 根据 
AIDL 文件 在 gen 目录 下 生成 java 接口 文件 IMathService. java, 

IMathService. java 文件 根据 IMathService. aidl 的 定义 ,生成 了 一 个 内 部 静态 抽象 类 
Stub ,如 图 7.7 所 示 ,Stub 继承 了 Binder 类 ,并 实现 IMathService 接口 。 在 Stub 类 中 ， 
还 包含 一 个 重要 的 静态 类 Proxy。 可 以 认为 Stub 类 用 来 实现 本 地 服务 调用 ,Proxy 类 用 
来 实现 远程 服务 调用 ,将 Proxy 作为 Stub 的 内 部 类 完全 是 出 于 使 用 方便 的 目的 。Stub 
类 和 Proxy 类 关系 如 图 7. 8 所 示 。 


dB eduhrbeuRemoteMathServiceDemo 
4 f IMathService 
4 ($^ Stub 
$F DESCRIPTOR : String 
@ ° Stubü 
© Š aslnterface(IBinder) : IMathService 
ө a asBinder0 : IBinder 
© a onTransact(nt, Parcel, Parcel, int) : boolean 
4 f° Proxy 
з mRemote : [Binder 


A * Proxy(IBinder) 
© a asBinder( : IBinder 
(9 getinterfaceDescriptor( : String 
ө a Add(long, long) : long 
¿F TRANSACTION Add : int 
€ Add(long, long) : long 


7.7 MathService. java 文件 结构 


下 面 给 出 IMathService. java 的 完成 代码 , 


1 package edu.hrbeu.RemoteMathServiceDemo; 
2 public interface IMathService extends android.os.IInterface( 
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AIDL 文 件 
IMathService.aidl 


AIDL 
工具 


成 Java 接 口 文件 


MathService.java 


生成 内 部 静态 抽象 Stub 类 
IMathService.Stub 


= ix 


生成 内 部 静态 Proxy 类 门 
IMathService.Stub.Proxy 


本 地 服务 对 象 远程 服务 对 象 
Stub.asInterface() 用 来 返 使 用 asInterface() 获 取 
远程 服务 对 象 (Proxy) 远程 Proxy 对 象 的 引用 
onTransact() Transact() 
IMathService.Stub IMathService.Stub.Proxy 
IMathService asInterface(IBinder obj) IBinder asBinder() 
IBinder asBinder() String getInterfaceDescriptor() 
boolean onTransact(int code, Parcel data, long Add(long a, long b) 
Parcel reply, int flags) 


7.8 Stub 类 和 Proxy 类 关系 图 


3  /** Local- side IPC implementation stub class. */ 

4 public static abstract class Stub extends android.os.Binder implements edu 
.hrbeu.RemoteMathServiceDemo.IMathService( 

5 private static final java.lang.String DESCRIPTOR- "edu.hrbeu 

-RemoteMathServiceDemo.IMathService"; 

6  /** Construct the stub at attach it to the interface. */ 

y public Stub()( 

8 this.attachInterface (this, DESCRIPTOR); 

9 


10 /** 

11 * Cast ап IBinder object into an IMathService interface, 

12 * generating a proxy if needed. 

13 */ 

14 public static edu.hrbeu.RemoteMathServiceDemo.IMathService asInterface (android. 
os.IBinder obj){ 

15 if((obj--null))( 


16 return null; 


18 


19 
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android.os.IInterface iin= (android.os.IInterface)obj 
-queryLocalInterface (DESCRIPTOR) ; 
if((Gin!-null)&& (iin instanceof edu.hrbeu.RemoteMathServiceDemo 
-IMathService)))( 
return((edu.hrbeu.RemoteMathServiceDemo.IMathService)iin); 
} 
return new edu.hrbeu.RemoteMathServiceDemo. IMathService. Stub. Proxy (0bj) ; 
) 
public android.os.IBinder asBinder () { 
return this; 
) 
public boolean onTransact (int code, android.os.Parcel data, android.os 
-Parcel reply, int flags)throws android.os.RemoteException( 
Switch (code) t 
case INTERFACE TRANSACTION: 
t 
reply.writeString (DESCRIPTOR); 
return true; 
) 
case TRANSACTION Add: 
t 
data.enforceInterface (DESCRIPTOR) ; 
long arg0; 
. arg0- data.readLong() ; 
long argl; 
.argl-data.readLong(); 
long result-this.Add( arg0, argl); 
reply.writeNoException|(); 
reply.writeLong( result); 


return true; 


) 
return super.onTransact (code, data, reply, flags); 
) 
private static class Proxy implements edu.hrbeu.RemoteMathServiceDemo 
.IMathService( 
private android.os.IBinder mRemote; 
Proxy (android.os.IBinder remote) { 
mRemote- remote; 
} 
public android.os.IBinder аѕВіпаег () { 
return mRemote; 
} 
public java.lang.String getInterfaceDescriptor (){ 
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58 return DESCRIPTOR; 

59 $ 

60 public long Ааа (long a, long b)throws android.os.RemoteException( 
61 android.os.Parcel data-android.os.Parcel.obtain(); 

62 android.os.Parcel reply-android.os.Parcel.obtain(); 

63 long result; 

64 try ( 

65 . data.writeInterfaceToken (DESCRIPTOR) ; 

66 . data.writeLong (а); 

67 . data.writeLong (b); 

68 mRemote.transact (Stub.TRANSACTION Add, data, reply, 0); 
69 . reply.readException(); 

70 .result- reply.readLong(); 

Ji } 

12 finally { 

73 _reply.recycle () ; 

74 _даса.гесус1е(); 

75 } 

76 return _result; 

77 } 

78 } 

79 static final int TRANSACTION Add- (IBinder.FIRST CALL TRANSACTION- 0); 
80 } 

81 public long Add (long a, long b)throws android.os.RemoteException; 

82 ] 


IMathService 继承 了 android. os. IInterface( 第 2 行 ) .这 是 所 有 使 用 AIDL 建立 的 接 
口 都 必须 继承 基 类 的 接口 。 这 个 基 类 接口 中 定义 了 asBinder( ) 方 法 ,用 来 获取 Binder 对 
象 。 在 代码 的 第 24 行 到 第 26 行 ,实现 了 android. os. Interface 接口 所 定义 的 asBinder( ) 方 
法 。 在 IMathService 中 , 绝 大 多 数 的 代码 是 用 来 实现 Stub 这 个 抽象 类 的 。 每 个 远程 接 
口 都 包含 Stub 类 ,因为 是 内 部 类 ,所 以 并 不 会 产生 命名 冲突 。 

asInterface(IBinder) Æ Stub 内 部 的 远程 服务 接口 ,调用 者 可 以 通过 该 方法 获取 远程 
服务 的 实例 。 仔 细 观 察 asInterface(IBinder) 实 现 方法 ,首先 判断 IBinder 对 象 obj 是 否 为 
null( 第 15 行 ), 如 果 是 则 立即 返回 。 然后 使 用 DESCRIPTOR 构造 android. os 
.IInterface 实 例 ( 第 18 行 ) ,并 判断 android. os. Interface 实例 是 否 为 本 地 服务 。 如 果 是 
本 地 服务 , 则 无 须 进行 进程 间 通 信 , 返 回 android. os. Interface 实例 (第 20 £30 ;如 果 不 是 
本 地 服务 , 则 构造 并 返回 Proxy 对 象 (第 22 47). 

Proxy 内 部 包含 与 IMathService. aidl 相同 签名 的 函数 (第 60 £30 ,并 且 在 该 函数 中 以 
一 定 的 顺序 将 所 有 参数 写 人 Parcel 对 象 ( 第 65—70 行 ), 以 供 Stub 内 部 的 onTransact() 
方法 能 够 正确 获取 参数 。 

当 数 据 以 Parcel 对 象 的 形式 传递 到 远程 服务 的 内 部 时 ,onTransact() 方 法 (第 27 行 ) 
将 从 Parcel 对 象 中 逐一 地 读 取 每 个 参数 ,然后 调用 Service 内 部 制定 的 方法 ,并 再 将 结果 
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写 人 另 一 个 Parcel 对 象 ,准备 将 这 个 Parcel 对 象 返回 给 远程 的 调用 者 。 

Parcel 是 Android 系统 中 应 用 程序 进程 间 数 据 传递 的 容器 ,能 够 在 两 个 进程 中 完成 
数据 的 打包 和 拆 包 的 工作 。 但 Parcel 不 同 于 通用 意义 上 的 序列 化 ,Parcel 的 设计 目的 是 
用 于 高 性 能 IPC 传输 ,因此 不 能 够 将 Parcel 对 象 保存 在 任何 持久 存储 设备 上 。 


2. 通过 继承 Service 类 实现 远程 服务 


IMathService. aidl 是 对 远程 服务 接口 的 定义 ,自动 生成 的 IMathService. java 内 部 实 
现 了 远程 服务 数据 传递 的 相关 方法 ,下 一 步 介绍 如 何 实现 远程 服务 。 实 现 远程 服务 需要 
建立 一 个 继承 android. app. Service 的 类 ,并 在 该 类 中 通过 onBind() 方 法 返回 IBinder 对 
象 ,调用 者 使 用 返回 的 IBinder 对 象 访问 远程 服务 。IBinder 对 象 的 建立 通过 使 用 
IMathService. java 内 部 的 Stub 类 实现 ,并 逐一 实现 在 IMathService. aidl 接口 文件 定义 
的 函数 。 在 RemoteMathServiceDemo 示例 中 ,远程 服务 的 实现 类 是 MathService. java, 
下 面 是 MathService. java 的 完整 代码 。 


package edu.hrbeu.RemoteMathServiceDemo; 


import android.app.Service; 
import android.content.Intent; 


import android.widget.Toast; 


public class MathService extends Service( 


š 
2 
3 
4 
5 import android.os.IBinder; 
6 
7 
8 
9 private final IMathService.Stub mBinder- new IMathService.Stub () ( 


10 public long Add (long a, long b)( 

11 return a+b; 

12 } 

13 J; 

14 @ Override 

15 public IBinder onBind (Intent intent) { 

16 Toast.makeText (this，" 远 程 绑 定 :MathService", 
17 Toast.LENGTH _ SHORT) .show () ; 

18 return mBinder; 

19 ) 

20 @ Override 

21 public boolean onUnbind (Intent intent) { 

22 Toast.makeText (this，" 取 消 远 程 绑 定 :MathService", 
23 Toast.LENGTH SHORT) .show () ; 

24 return false; 

25 } 

26 ) 


第 8 行 代码 表明 MathService 继承 于 android. app. Service, # 9 行 建 立 
IMathService. Stub 的 实例 mBinder, 并 在 第 10 行 实现 了 AIDL 文件 定义 的 远程 服务 接 
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口 。 第 18 行 在 onBind() 方 法 中 ,将 mBinder 返回 给 远程 调用 者 。 第 16 行 和 第 22 行 分 
Bs Us 

RemoteMathServiceDemo 示例 的 文件 结构 如 图 7. 9 所 示 。 示 例 中 只 有 远程 服务 的 
类 文件 MathService. java 和 接口 文件 IMathService. aidl, 没有 任何 显示 用 户 界 面 的 
Activity 文件 。 因 此 在 调试 RemoteMathServiceDemo 示例 时 ,模拟 器 上 不 会 有 任何 用 户 
界面 出 现 , 但 在 控制 台 会 有 “没有 找到 用 于 启动 的 Activity, 仅 将 应 用 程序 同步 到 设备 上 ” 
的 提示 信息 (如 图 7. 10 所 示 ) ,表明 . apk 文件 已 经 上 传 到 模拟 器 中 。 


I$ Package Explorer 2: | E] e| ш = 9 B 
EE RemoteMathServiceDemo 
> mÀ Google APIs [Android 5.0.1] 
4 (9 src 
> #8 edu.hrbeu.RemoteMathServiceDemo 
4 器 gen [Generated Java Files] 
4 8 edu.hrbeu.RemoteMathServiceDemo 
> [0 BuildConfig java 
b Í) IMathService java 
b D Rjava 
B assets 
b B bin 
b B res 
I, AndroidManifestxml 
B proguard.cfg 
В projectproperties 


7.9 RemoteMathServiceDemo 示例 文件 结构 


Android Launch! 

ladb is running men. 

INo Launcher activity fo 

The launch will only sync "the application package on the device! 
Performing sync 


utomatic Target Mode: using existing emulator 'emulator-5554' running compatible AVD 'AndroidSim4.@' 
Uploading RemoteMathServiceDemo.apk onto device 'emulator-5554' 

[Installing RemoteMathServiceDemo.apk... 

success! 

|MemoteMathServiceDemo bin WRemoteMathServiceDemo.apk installed on device 

ропе! 


图 7.10 RemoteMathServiceDemo 调试 信息 


为 了 进一步 确认 编译 好 的 . apk 文件 是 否 正确 上 传 到 模拟 器 中 ,可 以 使 用 File Explorer 
查看 模拟 器 的 文件 系统 。 如 果 能 在 /data/app/ 下 找到 edu. hrbeu. RemoteMathServiceDemo 
.apk 文 件 , 说 明 提 供 远程 服务 的 . арк 文件 已 经 正确 上 传 。RemoteMathServiceDemo 示 
例 无 法 在 Android 模拟 器 的 程序 启动 栏 中 找到 ,只 能 够 通过 其 他 应 用 程序 调用 该 示例 中 
的 远程 服务 。 图 7. 11 显示 了 edu. hrbeu. RemoteMathServiceDemo. apk 文件 的 保存 
位 置 。 

RemoteMathServiceDemo 是 本 书 中 第 一 个 没有 Activity 的 示例 ,在 AndroidManifest 
. xml 文 件 中 ,在 二 application 二 标签 下 只 有 一 个 二 service 二 标签 。 

AndroidManifest. xml 文件 的 完整 代码 如 下 。 
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i File Explorer 22 mal-i- == = | 
Мате Sie Date Time |E 
b Баса 2015-04-20 2037 
b © cache 2015-04-20 20:34 
国 charger 1969-12-31 19:00 
> © config 2015-04-20 20:37 
gd 2015-04-20 20:37 
4 © data 2015-04-20 20:35 
b © anr 2015-04-20 2036 
4 © app 2015-04-20 2039 
> @ъ ApiDemos 2015-04-20 20:34 
b © GestureBuilder 2015-04-20 20:34 
í » (> edu.hrbeu.RemoteMathServiceDemo-1 2015-04-20 20:39 
> © app-asec 2015-04-20 20:33 
> © app-lib 2015-04-20 20:33 
> C» app-private 2015-04-20 2033 
> © backup 2015-04-20 2039 
В bugreports 2015-04-20 20:33 
© dalvik-cache 2015-04-20 20:33 . 
T ————Ó— ‚ 
Ec] 


7.11  RemoteMathServiceDemo. арк 文件 位 置 


1 <?xml version= "1.0" encoding- "utf- 8"? > 

2 «manifest xmlns:android= "http://schemas.android.com/apk/res/android" 

3 package= "edu.hrbeu.RemoteMathServiceDemo" 

4 android:versionCode= "1" 

5 android:versionName- "1.0"» 

6 «application android:icon- "ё drawable/icon" android:label- "? string/app name" 


7 «service android:name- ".MathService" 

8 android:process- ":remote"» 

э «intent- filter> 

10 «action android: name =" edu. hrbeu. RemoteMathServiceDemo 


.MathService" /> 


11 < /intent- filter» 

12 < /service» 

13 < /application» 

14 « uses- sdk android:minSdkVersion- "14" /> 


15 «/manifest» 


这 里 注意 第 10 行 代码 ,edu. hrbeu. RemoteMathServiceDemo. MathService 是 远程 
调用 MathService 的 标识 ,调用 者 使 用 Intent. setAction O 函数 将 标识 加 入 Intent 中 , 然 
后 隐 式 启动 或 绑 定 服务 。 


3. 绑 定 和 使 用 远程 服务 


RemoteMathCallerDemo 示例 说 明 如 何 调用 RemoteMathServiceDemo 示例 中 的 远 
程 服务 。RemoteMathCallerDemo 的 界面 如 图 7. 12 所 示 ,用 户 可 以 绑 定 远程 服务 ,也 可 
以 取消 服务 绑 定 。 在 绑 定 远程 服务 后 ,调用 RemoteMathServiceDemo 中 的 MathService 
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服务 进行 加 法 运算 ,运算 的 输入 由 RemoteMathCallerDemo 随机 产生 ,运算 的 输入 和 结 
果 显 示 在 屏幕 的 上 方 。 

应 用 程序 在 调用 远程 服务 时 ,需要 具有 相同 的 Proxy 类 和 签名 调用 函数 ,这 样 才能 
够 使 数据 在 调用 者 处 打包 后 在 远程 服务 处 正确 拆 包 ,反之 亦 然 。 从 实践 角度 来 讲 , 调 用 
者 需要 使 用 与 远程 服务 端 相同 的 AIDL 文件 。RemoteMathCallerDemo 示例 中 ,在 edu 
. hrbeu. RemoteMathServiceDemo 包 下 引入 与 RemoteMathServiceDemo 相同 的 AIDL 
文件 IMathService. aidl, 所 以 在 gen 目录 下 会 自动 生成 相同 的 IMathService. java 文件 。 
RemoteMathServiceDemo 的 文件 结构 如 图 7. 13 所 示 。 


ÍŠ Package Explorer 2 G $| v — B 
4 (9 RemoteMathCallerDemo 
mà Google APIs [Android 5.0.1] 
4 (9 src 
4 8 eduhrbeu.RemoteMathCallerDemo 
[Jj] RemoteMathCallerDemoActivity.java 
4 {B edu.hrbeu.RemoteMathServiceDemo 
В IMathService.aidl 
а $9 gen [C Java Files] 
4 8 edu hrbeu.RemoteMathCallerDemo 
RemoteMathCallerDemo B) BuildConfig java 
国 Rjava 
出 edu.hrbeu.RemoteMathServiceDemo 
远程 服务 绑 定 由 RemoteMathserviceDemo 
> assets 
bin 
res 
AndroidManifestxml 


取消 服务 绑 定 


к (22 


加 法 运算 9 proguard.cfg 


В project.properties 


图 7.12 RemoteMathCallerDemo 用 户 界 面 7.13 RemoteMathCallerDemo 的 文件 结构 


RemoteMathCallerDemoActivity. java 是 Activity 的 文件 ,远程 服务 的 绑 定 和 使 用 方 
法 与 7.2. 3 节 的 本 地 服务 绑 定 示例 SimpleMathServiceDemo 相似 。 不 同 之 处 主要 包括 
以 下 两 处 ,一 是 使 用 IMathService 声明 远程 服务 实例 (代码 第 1 行 ); 二 是 通过 
IMathService. Stub 的 asInterface( ) 方 法 实现 获取 服务 实例 (代码 第 6 47). 


x private IMathService mathService; 

З private ServiceConnection mConnection- new ЅегуісеСоппесііоп () { 
4 @ Override 

5 public void onServiceConnected (ComponentName name, IBinder service) { 
6 mathService- IMathService.Stub.asInterface (service); 

7 } 

8 @ Override 

9 public void onServiceDisconnected (ComponentName пате) { 

10 mathService- null; 

Ad } 

12 


绑 定 服务 时 ,首先 通过 setAction() 方 法 声明 服务 标识 ,然后 调用 bindService() 绑 定 
服务 。 服 务 标识 必须 与 远程 服务 在 AndroidManifest. xml 文件 中 声明 的 服务 标识 完全 相 
同 。 因 此 本 示例 的 服务 标识 为 edu. hrbeu. RemoteMathServiceDemo. MathService , 5j 3€ 
程 服务 示例 RemoteMathServiceDemo 在 AndroidManifest. xml 文件 声明 的 服务 标识 


=з. 
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final Intent serviceIntent=new Intent(); 


serviceIntent.setAction ("edu.hrbeu.RemoteMathServiceDemo .MathService"); 


bindService (serviceIntent,mConnection,Context.BIND AUTO CREATE); 


下 面 给 出 RemoteMathCallerDemoActivity. java 文件 的 完整 代码 。 


package edu.hrbeu.RemoteMathCallerDemo; 


import edu.hrbeu.RemoteMathServiceDemo.IMathService; 


import android.app.Activity; 

import android.content .ComponentName; 
import android.content.Context; 
import android.content.Intent; 

import android.content.ServiceConnection; 
import android.os.Bundle; 

import android.os.IBinder; 

import android.os.RemoteException; 
import android.view.View; 

import android.widget.Button; 

import android.widget.TextView; 


public class RemoteMathCallerDemoActivity extends Activity ( 


private IMathService mathService; 


private ServiceConnection mConnection- new ServiceConnection () { 

@ Override 

public void onServiceConnected (Сопропеп Мате name, IBinder ѕегуісе) { 
mathService- IMathService.Stub.asInterface (service); 

} 

@ Override 

public void onServiceDisconnected (ComponentName name) { 
mathService- null; 


J; 


private boolean isBound= false; 


TextView labelView; 
@ Override 
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35 
36 
37 
38 
39 
40 
41 
42 
43 
44 
45 
46 
47 
48 


49 


50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
74 
75 


public void onCreate (Bundle savedInstanceState) { 


super.onCreate (savedInstanceState); 
setContentView (R.layout.main); 


labelView- (TextView)findViewById (R.id.label); 

Button bindButton- (Button) findViewById (R.id.bind); 

Button unbindButton- (Button) findViewById (R.id.unbind); 
Button computButton- (Button) findViewById (R.id.compute add); 


bindButton.setOnClickListener (new View.OnClickListener()( 
@ Override 
public void onClick (View v) ( 
if (!isBound)( 
final Intent serviceIntent- new Intent () ; 
serviceIntent.setAction ("edu.hrbeu 
-RemoteMathServiceDemo.MathService"); 


bindService (serviceIntent, mConnection, Context. BIND | AUTO _ 


CREATE) ; 


isBound-true; 


unbindButton.setOnClickListener (new View.OnClickListener () { 
@ Override 
public void onClick (View у) { 
if (isBound)( 
isBound- false; 
unbindService (mConnection); 


mathService-null; 


computButton.setOnClickListener (new View.OnClickListener () { 
@ Override 
public void onClick (View у) { 
if (mathService==null){ 
labelView.setText (" 未 绑 定 远程 服务 ") ; 
return; 
) 
long a-Math.round (Math.random() * 100); 
long b-Math.round (Math.random() * 100); 


long result- 0; 
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76 try { 
TI result-mathService.Add (a, b); 
78 ) catch (RemoteException е) { 
79 e.printStackTrace (); 
80 } 
81 String msg=String.valueOf (а) + "+ "+ String.valueOf (b)+ 
82 "="+String.valueOf (result); 
83 labelView.setText (msg) ; 
84 } 
85 р; 
86 } 
87 } 
733 数据 传递 


在 Android 系统 中 ,进程 间 传递 的 数据 包括 Java 语言 支持 的 基本 数据 类 型 和 用 户 自 
定义 的 数据 类 型 。 为 了 使 数据 能 够 穿越 进程 边界 ,所 有 数据 都 必须 是 “可 打包 ”的 。 对 于 
Java 语言 的 基本 数据 类 型 ,打包 过 程 是 自动 完成 的 。 但 对 于 自 定义 的 数据 类 型 ,用 户 则 
需要 实现 Parcelable 接口 ,使 自 定 义 的 数据 类 型 能 够 转换 为 系统 级 原 语 保 存在 Parcel 对 
象 中 ,穿越 进程 边界 后 可 再 转换 为 初始 格式 。AIDL 支持 的 数据 类 型 见 表 7.1. 


表 7.1 AIDL 支持 的 数据 类 型 


类 型 说 RB 需要 引入 
Java 语言 的 基本 类 型 包括 boolean、byte、short、int,float 和 double 等 fü 
String java. lang. String f 
CharSequence java. lang. CharSequence f? 
List 其 中 所 有 的 元 素 都 必须 是 AIDL 支持 的 数据 类 型 否 
Map 其 中 所 有 的 键 和 元 素 都 必须 是 AIDL 支持 的 数据 类 型 fi 
其 他 AIDL 接口 任何 其 他 使 用 AIDL 语言 生成 的 接口 类 型 是 
Parcelable 对 象 实现 Parcelable 接口 的 对 象 是 


下 面 以 ParcelMathServiceDemo 示例 为 参考 ,说 明 如 何在 远程 服务 中 使 用 自 定 义 数 
据 类 型 。 这 个 示例 是 RemoteMathServiceDemo 示例 的 延续 ,也 定义 了 MathService 服 
务 ,同样 可 以 为 远程 调用 者 提供 加 法 服务 。 而 且 同 样 也 是 没有 启动 界面 ,因此 在 模拟 器 
的 调试 过 程 与 RemoteMathServiceDemo 示例 相同 。 

不 同 之 处 在 于 MathService 服务 增加 了 “全 运算 ”功能 ,在 接收 到 输入 参数 后 ,将 向 调 
用 者 返回 一 个 包含 “加 \ 减 .乘除 ”全 部 运算 结果 的 对 象 。 这 个 对 象 是 一 个 自 定义 的 类 ， 
为 了 能 够 使 其 他 AIDL 文件 可 使 用 这 个 自 定义 类 ,需要 使 用 AIDL 语言 声明 这 个 类 。 

ParcelMathServiceDemo 示例 的 文件 结构 如 图 7. 14 所 示 。 

首先 建立 AllResult. aidl 文件 ,声明 AllResult 类 。 在 第 2 行 代 码 中 使 用 parcelable 
声明 自 定义 类 ,这 样 其 他 的 AIDL 文件 就 可 以 使 用 这 个 自 定义 的 类 。AllResult. aidl 文件 
的 代码 如 下 。 


190 Ф... iain (узж) 
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Package Explorer X| E] S| ç = B 
ттеу —. DE] 
> BÀ Google APIs [Android 5.0.1] 
4 (9 src 
4 8 eduhrbeu.ParcelMathServiceDemo 
> B) AllResultjava 
> (0 MathServicejava 
B AllResult.aidl 
B IMathService.aidl 
4 $9 gen [Generated Java Files] 
4 88 edu.hrbeu.ParcelMathServiceDemo 
> B) BuildConfig java 
> 10 IMathServicejava 
> B) Rjava 
B assets 
b B bin 
b б res 
回 AndroidManifestxml 
В proguard.cfg 


В project.properties 


7.14  ParcelMathServiceDemo 示例 的 文件 结构 


package edu.hrbeu.ParcelMathServiceDemo; 
parcelable AllResult; 


在 IMathService. aidl 文件 中 ,代码 第 6 行为 全 运算 增加 了 新 的 函数 ComputeAll() . 
该 函数 的 返回 值 就 是 在 AllResult. aidl 文件 中 定义 AllResult。 同 时 ,为 了 能 够 使 用 自 定 
义 数据 结构 AllResult, 在 代码 中 须 引 入 ейи. hrbeu. ParcelMathServiceDemo. AllResult 
包 。 第 2 行 和 第 6 行 是 新 增 的 代码 ,其 他 的 代码 与 RemoteMathServiceDemo 示例 相同 。 


- o 0c ^0 ыы 


package edu.hrbeu.ParcelMathServiceDemo; 
import edu.hrbeu.ParcelMathServiceDemo.AllResult; 


interface IMathService ( 

long Add (long a, long b); 

AllResult ComputeAll (long a, long b); 
) 


在 AIDL 文件 定义 完毕 后 ,下 一 步 来 介绍 如 何 构造 AllResult ж. AllResult 类 除了 
基本 的 构造 函数 以 外 ,还 需要 有 以 Parcel 对 象 为 输入 的 构造 郴 数 , 并 且 需 要 重 载 打 包 函 
数 writeToParcel() 。 

AllResult. java 文件 的 完整 代码 如 下 。 


чо л e шю оҥ 


package edu.hrbeu.ParcelMathServiceDemo; 


import android.os.Parcel; 


import android.os.Parcelable; 


public class AllResult implements Parcelable { 
public long AddResult; 
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public long SubResult; 
public long MulResult; 
public double DivResult; 


public AllResult (long addRusult, long subResult, 
divResult)( 

AddResult- addRusult; 

SubResult- subResult; 

MulResult-mulResult; 

DivResult- divResult; 


public AllResult (Parcel parcel) { 
AddResult- parcel.readLong|(); 
SubResult- parcel.readLong(); 
MulResult- parcel.readLong(); 
DivResult- parcel.readDouble () ; 


@ Override 
public int describeContents () ( 


return 0; 


@ Override 
public void writeToParcel (Parcel dest, int flags) { 
dest.writeLong (AddResult); 
dest.writeLong (SubResult); 
dest.writeLong (MulResult); 
dest.writeDouble (DivResult); 
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long mulResult, 


public static final Parcelable.Creator« AllResult» CREATOR- 


new Parcelable.Creator« AllResult» (){ 

public AllResult createFromParcel (Parcel parcel) { 
return new AllResult (parcel); 

} 

public AllResult[] newArray (int size) { 


return new AllResult [size]; 


double 


代码 第 6 行 说 明了 AllResult 类 继承 于 Parcelable。 代 码 第 7 行 到 第 10 行 用 来 保存 
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全 运算 的 运算 结果 。 第 12 行 是 AllResult 类 的 基本 构造 函数 。 第 19 行 也 是 类 的 构造 函 
数 ,支持 Parcel 对 象 实例 化 AllResult。 代 码 第 32 行 的 writeToParcel() 是 “打包 ”函数 ， 
将 AllResult 类 内 部 的 数据 ,按照 特定 的 顺序 写 和 人 Parcel 对 象 , 写 人 的 顺序 必须 与 构造 函 
数 的 读 取 顺序 一 致 (代码 第 20 行 到 第 23 行 )。 第 39 行 实现 了 静态 公共 字段 Creator, Hj 
来 使 用 Parcel 对 象 构 造 AllResult 对 象 。 

在 MathService. java 文件 中 ,增加 了 用 来 进行 全 运算 的 Comput Al O 函数 ,并 将 运 
算 结 果 保 存在 AllResult 对 象 中 。 

MathService. java 文件 中 的 ComputAlLO 函数 实现 代码 如 下 。 


1 @Оуеггїде 

2 public AllResult ComputeAll (long a, long b)throws RemoteException ( 
3 long addRusult- а+р; 

4 long subResult- a-b; 

5 long mulResult-a * b; 
6 

7 

8 

9 


double divResult= (double)a / (double)b; 
AllResult allResult=new AllResult (addRusult, subResult, mulResult, divResult); 
return allResult; 


) 


ParcelMathCallerDemo 示例 是 ParcelMathServiceDemo 示例 中 MathService 服务 的 调用 
者 ,文件 结构 如 图 7.15 所 示 。 其 中 .AllResult. aidl AllResult. java 和 IMathService. aidl 文件 
必须 与 ParcelMathServiceDemo 示例 的 三 个 文件 完全 一 致 ,否则 会 出 现 错误 。 


I$ Package Explorer 2: BE S| 
4 (02 ParcelMathCallerDemo| 
> mh Google APIs [Android 5.0.1] 
4 (9 src 
4 8 eduhrbeu.ParcelMathCallerDemo 
> [D ParcelMathCallerDemoActivityjava 
4 EB edu.hrbeu.ParcelMathServiceDemo 
b D AllResultjava 
B AllResult.aidl 
В IMathService.aidl 
4 $9 gen [Generated Java Files] 
4 8 eduhrbeu.ParcelMathCallerDemo 
> D BuildConfig java 
b D Rjava 
4 Д8 edu.hrbeu.ParcelMathServiceDemo 
b [J] IMathServicejava 
B assets 
B bin 
B res 
E) AndroidManifest.xml 
В proguard.cfg 
В project properties 


В 7.15  ParcelMathCallerDemo 的 文件 结构 


在 图 7. 16 的 ParcelMathCallerDemo 界面 中 可 以 发 现 ,原来 的 “加 法 运算 ”按钮 改 为 
了 “全 运算 ”按钮 ,运算 结果 显示 在 界面 的 上 方 。 
下 面 也 仅 给 出 ParcelMathCallerDemo. java 文件 与 RemoteMathCallerDemo 示例 
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ParcelMathCallerDemo 


远程 服务 绑 定 


图 7.16 ParcelMathCallerDemo 用 户 界面 


RemoteMathCallerDemoActivity. java 文件 不 同 的 代码 段 。 定 义 了 “全 运算 ”按钮 的 监听 


函数 ,随机 产生 输入 值 , 调 用 远程 服务 ,获取 运算 结果 ,并 将 运算 结果 显示 在 用 户 界面 上 。 
10 computAllButton.setOnClickListener (new View.OnClickListener () { 
11 @ Override [а] 
12 public void onClick (View у) { 
13 if (mathService--null)( A 
14 labelView.setText (" : 
15 return; 
16 } 
17 long a-Math.round (Math.random() * 100); 
18 long b-Math.round (Math.random() * 100); 
19 AllResult result=null; 
20 try { 
21 result-mathService.ComputeAll (a, b); 


22 ) catch (RemoteException е) { 


23 e.printStackTrace|(); 

24 } 

25 String msg= ""; 

26 if (result !—-null)( 

27 msg* — String.valueOf (а) + "+ "+ String.valueOf (b)+ "= "4 String 


-valueOf (result .AddResult)+ "Nn"; 


28 msg+= String.valueOf (а) + "- "+ String.valueOf (b) + "="+ String 


-valueOf (result .SubResult)+ "Nn"; 


29 msg+=String.valueOf(a)+" * "+String.valueOf (b)+ "= "+String 
.valueof (result.MulResult)- "Nn"; 
30 msg+=String.valueOf (a)+" / "+String.valueOf (b)+ "= "+ String 


-valueOf (result.DivResult); 
= } 
32 labelView.setText (msg); 


194 Чулак аня (Ж 31 ) 


за р; 


= ER 


1. 简 述 Service 的 基本 原理 和 用 途 。 

2. 编程 建立 一 个 简单 的 进程 内 服务 ,实现 比较 两 个 整数 大 小 的 功能 。 服 务 提供 Int 
Compare(Int, Int) 函数 ,输入 两 个 整数 ,输出 较 大 的 整数 。 

3. 使 用 AIDL 语言 实现 功能 与 第 2 题 相同 的 跨 进程 服务 。 


数据 存储 与 访问 


Android 系统 提供 多 种 的 数据 存储 方法 ,包括 易于 使 用 的 SharedPreferences、 经 典 的 
文件 存储 和 轻 量 级 的 SQLite 数据 库 , 不 同 的 数据 存储 方法 有 着 不 同 的 适用 领域 。 通 过 
本 章 的 学 习 可 以 让 读者 了 解 Android 系统 各 种 数据 存储 方法 的 特点 和 使 用 方法 ,掌握 跨 
进程 的 数据 共享 方法 。 

本 章 学 习 目 标 : 

。 掌握 SharedPreferences 的 使 用 方法 ; 

。 掌握 各 种 文件 存储 的 区 别 与 适用 情况 ; 

* 了 解 SQLite 数据 库 的 特点 和 体系 结构 ; 

。 掌握 SQLite 数据 库 的 建立 和 操作 方法 ; 

* 理解 ContentProvider 的 用 途 和 原理 ; 

。 掌握 ContentProvider 的 创建 与 使 用 方法 。 
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8.1.1 SharedPreferences 


在 应 用 程序 的 使 用 过 程 中 ,用 户 经 常会 根据 自己 的 习惯 更 改 应 用 程序 的 设置 ,或 者 
根据 自己 的 喜好 设 定 个 性 化 内 容 。 为 了 能 保存 配置 信息 和 个 性 化 内 容 , 应 用 程序 一 般 在 
文件 系统 中 保存 一 个 配置 文件 ,并 在 每 次 程序 启动 时 读 取 配 置 文件 的 内 容 。 

在 文件 系统 中 使 用 配置 文件 .需要 注意 配置 文件 的 格式 ,一 般 使 用 INI X tsk XML 
文件 ,当然 也 可 以 自 定义 文件 格式 。INI 文件 格式 简单 .容易 读 懂 ,但 须 使 用 代码 实现 文 
件 读 取 和 写 人 。XML 文件 有 成 熟 的 类 支持 ,在 代码 方面 更 容易 实现 ,但 可 读 性 上 要 比 
INI 文 件 差 一 些 。 无 论 是 使 用 INI 文 件 , 还 是 使 用 XML 文件 保存 配置 信息 和 个 性 化 内 
# ,程序 开发 人 员 都 需要 进行 繁琐 的 编码 实现 文件 读 写 操作 。 

Android 为 开发 人 员 提 供 了 更 为 简单 的 数据 存储 方法 SharedPreferences。 这 是 一 种 
轻 量 级 的 数据 保存 方式 ,通过 SharedPreferences 开发 人 员 可 以 将 NVP ( Name/ Value 
Pair, 名 称 / 值 对 ) 保 存在 Android 的 文件 系统 中 ,而 且 SharedPreferences 完全 屏蔽 了 对 
文件 系统 的 操作 过 程 , 开 发 人 员 仅 通过 调用 SharedPreferences 中 的 函数 就 可 以 实现 对 
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МУР 的 保存 和 读 取 。 

SharedPreferences 不 仅 能 够 保存 数据 ,还 能 够 实现 不 同 应 用 程序 间 的 数据 共享 。 
SharedPreferences 支持 三 种 访问 模式 : £4 MODE. PRIVATE). £ Ja iE (МОРЕ _ 
WORLD _ READABLE) 和 全 局 写 (MODE _ WORLD _ WRITEABLE)。 如 果 将 
SharedPreferences 定义 为 私有 模式 , 仅 创 建 SharedPreferences 的 程序 有 权限 对 其 进行 读 
取 或 写 人 ;如 果 将 SharedPreferences 定义 为 全 局 读 模 式 ,不仅 创建 程序 可 以 对 其 进行 读 
取 或 写 人 ,其 他 应 用 程序 也 具有 读 取 操作 的 权限 ,但 没有 写 和 操作 的 权限 ;如 果 将 
SharedPreferences 定义 为 全 局 写 模式 , 则 所 有 程序 都 可 以 对 其 进行 写 人 操作 ,但 没有 读 
取 操 作 的 权限 。 

在 使 用 SharedPreferences 前 , 先 定义 SharedPreferences 的 访问 模式 。 下 面 的 代码 
将 访问 模式 定义 为 私有 模式 。 


1 public static int MODE=MODE PRIVATE; 


有 的 时 候 需 要 将 SharedPreferences 的 访问 模式 设 定 为 既 可 以 全 局 读 ,也 可 以 全 局 
写 , 这 就 需要 将 两 种 模式 写成 下 面 的 方式 : 

1 public static int MODE= Context.MODE WORLD READABLE+ Context.MODE WORLD WRITEABLE; 

除了 定义 SharedPreferences 的 访问 模式 ,还 要 定义 SharedPreferences 的 名 称 , 这 个 
名 称 也 是 SharedPreferences 在 Android 文件 系统 中 保存 的 文件 名 称 。 一 般 将 
SharedPreferences 名 称 声明 为 字符 串 常 量 ,这 样 可 以 在 代码 中 多 次 使 用 : 

1 public static final String PREFERENCE МАМЕ= "SaveSetting"; 

使 用 SharedPreferences 时 需要 将 访问 模式 和 SharedPreferences 名 称 作 为 参数 传递 
到 getSharedPreferences() 函 数 , 则 可 获取 SharedPreferences 实例 。 

1 SharedPreferences sharedPreferences= getSharedPreferences (PREFERENCE МАМЕ, MODE); 

在 获取 SharedPreferences 实例 后 ,可 以 通过 SharedPreferences. Editor 类 对 
SharedPreferences 进行 修改 ,最 后 调用 commit O 函数 保存 修改 内 容 。SharedPreferences 
广泛 支持 各 种 基本 数据 类 型 ,包括 整 型 .布尔 型 . 浮 点 型 和 长 型 等 。 
SharedPreferences.Editor editor- sharedPreferences.edit (); 


editor.putString ("Name", "Tom"); 
editor.putInt ("Age", 20); 


editor.putFloat ("Height", 1.81f); 


а ь шю P 


editor.commit(); 


如 果 需 要 从 已 经 保存 的 SharedPreferences 中 读 取 数据 ,同样 是 调用 
getSharedPreferences O 函数 ,并 在 函数 第 1 个 参数 中 指明 需要 访问 的 SharedPreferences 
名 称 ,最 后 通过 get < Type > O 函数 获 取保 存在 SharedPreferences 中 的 NVP. get 
<Type> O KAHE 1 个 参数 是 NVP 的 名 称 , 第 二 个 参数 是 默认 值 ,在 无 法 获取 数值 时 
使 用 。 
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x SharedPreferences sharedPreferences- getSharedPreferences (PREFERENCE 
NAME, MODE); 

2 String name= sharedPreferences.getString ("Name", "Default Name"); 

3 int age- sharedPreferences.getInt ("Age", 20); 
4 


float height- sharedPreferences.getFloat ("Height",1.81f); 


812 示例 


到 这 里 已 经 介绍 了  SharedPreferences 的 使 用 方法 ,下 面 将 通过 
SimplePreferenceDemo 示例 介绍 SharedPreferences 的 文件 保存 位 置 和 保存 格式 。 
SimplePreferenceDemo 示例 的 用 户 界面 如 图 8. 1 所 示 , 用 户 在 界面 上 的 输入 信息 ,在 
Activity 关闭 时 通过 SharedPreferences 进行 保存 。 当 应 用 程序 重新 开启 时 ,再 通过 
SharedPreferences 将 信息 读 取 出 来 ,并 重新 呈现 在 用 户 界 面 上 。 


SimplePreferenceDemo 


Тот 


20 


1.81 


图 8.1 SimplePreferenceDemo 用 户 界 面 


SimplePreferenceDemo 示例 运行 并 通过 回 退 键 退出 后 ,通过 FileExplorer 查看 / 
data/data 下 的 数据 ,Android 系统 为 每 个 应 用 程序 建立 了 与 包 同 名 的 目录 ,用 来 保存 应 
用 程序 产生 的 数据 文件 ,包括 普通 文件 .SharedPreferences 文件 和 数据 库 文件 等 。 
SharedPreferences 产生 的 文件 就 保存 在 /data/data/ 二 package name /shared_prefs Н 
X P. 

在 本 示例 中 , shared. prefs 目录 中 生成 了 一 个 名 为 SaveSetting. xml 的 文件 ,如 
图 8.2 所 示 , 保 存在 /data/data/edu. hrbeu. SimplePreferenceDemo/shared _ prefs 目录 
下 。 这 个 文件 就 是 保存 SharedPreferences 的 文件 ,文件 大 小 为 170 字 节 ,在 Linux 下 的 
权限 为 -rw-rw-rw。 

在 Linux 系统 中 ,文件 权限 分 别 描述 了 创建 者 、 同 组 用 户 和 其 他 用 户 对 文件 的 操作 
限制 。x 表示 可 执行 ,r 表示 可 读 ,w 表示 可 写 ,d 表示 目录 ,- 表 示 普 通 文件 。 因 此 ,-rw 
rw-rw 表示 SaveSetting. xml 可 以 被 创建 者 、 同 组 用 户 和 其 他 用 户 进 行 读 取 和 写 和 操作， 
但 不 可 执行 。 产 生 这 样 的 文件 权限 与 程序 人 员 设 定 的 SharedPreferences 的 访问 模式 有 
关 ,-rw-rw-rw 的 权限 是 “全 局 读 十 全 局 写 ” 的 结果 。 如 果 将 SharedPreferences 的 访问 模 
式 设 置 为 私有 , 则 文件 权限 将 成 为 -rw-rw 一 ,表示 仅 有 创建 者 和 同 组 用 户 具有 读 写 文件 
的 权限 。 
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esa (узж) 


ifj File Explorer 13 mai-i* =n; 
Name Sie Date Time 
| 4 © edu,hrbue,SimplePreferenceDemo 2015-04-22 20:53 
2015-0422 2052 
2015-04-22 20:52 
2015-04-22 2053 
182 2015-04-22 2053 -rw-nw-rw- 


> @ eduice mikuactivigmainactivig 2015-03-26 08:36 Ir] 
£» jp.co.omronsoft.openwnn 2015-03-26 08:31 
» @ dontpanic 2015-03-24 2226 
Б drm 2015-03-24 22:26 - 


8.2 SaveSetting. xml 文件 


SaveSetting. xml 文件 是 以 XML 格式 保存 的 信息 ,内 容 如 下 。 


<?xml version= '1.0' encoding- 'utf- 8' standalone- 'yes' ?> 
«map» 
« float name- "Height" value- "1.81" /» 


< string name= "Name"? Tom< /string» 


i 
2 
d 
4 
5 « int name- "Age" value- "20" /» 
6 


< /map> 


SimplePreferenceDemo 示例 在 onStart O 函数 中 调用 loadSharedPreferences O 函数 ， 
读 取保 存在 SharedPreferences 中 的 姓名 、 年 龄 和 身高 信息 ,并 显示 在 用 户 界面 上 。 当 
Activity 关闭 时 ,在 onStop() 函 数 调用 saveSharedPreferences() ,保存 界面 上 的 信息 。 下 
面 给 出 示例 的 完整 代码 。 

SimplePreferenceDemoA ctivity. java 的 完整 代码 。 


package edu.hrbeu.SimplePreferenceDemo; 


import android.app.Activity; 


import android.content.Context; 


import android.os.Bundle; 


1 
2 
3 
4 
5 import android.content.SharedPreferences; 
6 
rà import android.widget.EditText; 

8 

9 


public class SimplePreferenceDemoActivity extends Activity ( 


10 

11 private EditText nameText; 

12 private EditText ageText; 

13 private EditText heightText; 

14 public static final String PREFERENCE NAME- "SaveSetting"; 

15 public static int MODE = Context. MODE WORLD _ READABLE + Context. MODE WORLD | 
WRITEABLE; 

16 

17 @ Override 

18 public void onCreate (Bundle savedInstanceState) { 

19 super.onCreate (savedInstanceState); 


20 setContentView (R.layout.main); 
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21 nameText= (EditText)findViewById(R.id.name); 

22 ageText= (EditText) ҒіпауіемВута (R.id.age); 

28 heightText= (EditText)findViewById(R.id.height); 

24 } 

25 

26 @ Override 

2T public void onStart () ( 

28 super.onStart () 7 

29 loadSharedPreferences(); 

30 } 

3t @ Override 

32 public void onStop()( 

33 super.onStop(); 

34 saveSharedPreferences() ; 

35 } 

36 

37 private void loadSharedPreferences () { 

38 SharedPreferences sharedPreferences=getSharedPreferences 
(PREFERENCE_NAME, MODE) ; 

39 String name= sharedPreferences.getString ("Name", "Tom") 7 

40 int age=sharedPreferences.getInt ("Age", 20); 

41 float height= sharedPreferences.getFloat ("Height",1.81f); 

42 

43 nameText .setText (name) ; 

44 ageText.setText (String.valueOf (age) ) ; 

45 heightText.setText (String.valueOf (height)); 

46 } 

47 

48 private void saveSharedPreferences () { 

49 SharedPreferences sharedPreferences- getSharedPreferences 
(PREFERENCE NAME, MODE); 

50 SharedPreferences.Editor editor- sharedPreferences.edit(); 

51 

52 editor.putString ("Name", nameText.getText ().toString()); 

53 editor.putInt ("Age", Integer.parseInt (ageText .getText () .toString())); 

54 editor.putFloat ("Height", Float.parseFloat (heightText.getText () . 


toString())); 
55 editor.conmmit () ; 
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虽然 SharedPreferences 能 够 为 开发 人 员 简 化 数据 存储 和 访问 过 程 ,但 直接 使 用 文件 
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系统 保存 数据 仍然 是 Android 数据 存储 中 不 可 或 缺 的 组 成 部 分 。Android 使 用 Linux 的 
文件 系统 ,开发 人 员 可 以 建立 和 访问 程序 自身 建立 的 私有 文件 ,也 可 以 访问 保存 在 资源 
目录 中 的 原始 文件 和 XML 文件 ,还 可 以 将 文件 保存 在 ТЕ 卡 等 外 部 存储 设备 中 。 
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Android 系统 允许 应 用 程序 创建 仅 能 够 被 自身 访问 的 私有 文件 ,文件 保存 在 设备 的 
内 部 存储 器 上 ,在 Android < 9 F BJ/data/data/—< package name 二 /files 目录 中 。 
Android 系统 不 仅 支持 标准 Java 的 IO 类 和 方法 ,还 提供 了 能 够 简化 读 写 流 式 文件 过 程 
的 函数 。 这 里 主要 介绍 两 个 函数 openFileOutput() 和 openFileInputO 。 
openFileOutput() 函 数 为 写 信 数据 做 准备 而 打开 文件 。 如 果 指 定 的 文件 存在 ,直接 
打开 文件 准备 写 和 数据; 如果 指定 的 文件 不 存在 , 则 创建 一 个 新 的 文件 。 
openFileOutput() 函 数 的 语法 格式 如 下 。 


public FileOutputStream openFileOutput (String name, int mode) 

第 1 个 参数 是 文件 名 称 , 这 个 参数 不 可 以 包含 描述 路 径 的 斜 杠 。 第 2 个 参数 是 操作 
模式 ,Android 系统 支持 4 种 文件 操作 模式 ,文件 操作 模式 说 明 参 考 表 8. 1。 函 数 的 返回 
值 是 FileOutputStream 类 型 。 

表 8.1 4 种 文件 操作 模式 
模 式 说 BB 


私有 模式 ,缺陷 模式 ,文件 仅 能 够 被 创建 文件 的 程序 访问 ,或 具有 
相同 UID 的 程序 访问 


MODE_APPEND 追加 模式 ,如 果 文 件 已 经 存在 , 则 在 文件 的 结尾 处 添加 新 数据 
MODE WORLD READABLE | 全 局 读 模式 ,允许 任何 程序 读 取 私有 文件 
MODE WORLD WRITEABLE | 全 局 写 模式 ,人 允许 任何 程序 写 和 人 私有 文件 


MODE_PRIVATE 


使 用 openFileOutput O 函数 建立 新 文件 的 示例 代码 如 下 。 


String FILE NAME- "fileDemo.txt"; 

FileOutputStream fos= openFileOutput (FILE NAME,Context.MODE PRIVATE) 
String text- "Some data"; 

fos.write(text.getBytes()); 

fos.flush(); 


is 


ольш Mc 


fos.close(); 


代码 首先 定义 文件 的 名 称 为 fileDemo. txt, 然 后 使 用 openFileOutput() 函 数 以 私有 
模式 建立 文件 ,并 调用 writeO 函数 将 数据 写 和 文件 ,调用 flush() 函 数 将 缓冲 数据 写 入 文 
件 ,最 后 调用 close() 函数 关闭 FileOutputStream。 

为 了 提高 文件 系统 的 性 能 ,一 般 调 用 write() 函数 时 ,如 果 写 入 的 数据 量 较 小 ,系统 
会 把 数据 保存 在 数据 缓冲 区 中 ,等 数据 量 积攒 到 一 定 程度 时 再 将 数据 一 次 性 写 入 文件 。 
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因此 ,在 调用 close() 函数 关闭 文件 前 ,务必 要 调用 flush() 函 数 ,将 缓冲 区 内 所 有 的 数据 
写 和 文件。 如果 开 发 人 员 在 调用 close() 函 数 前 没有 调用 flush(), 则 可 能 导致 部 分 数据 

openFileInput O 函数 为 读 取 数 据 做 准备 而 打开 文件 。openFileOutput() 函数 的 语法 
格式 如 下 。 


public FileInputStream openFileInput (String name) 
第 1 个 参数 也 是 文件 名 称 ,同样 不 允许 包含 描述 路 径 的 斜 枉 。 使 用 openFilelnputO 
函数 打开 已 有 文件 ,并 以 二 进 制 方式 读 取 数据 的 示例 代码 如 下 。 
String FILE NAME- "fileDemo.txt"; 
FileInputStream fis- openFileInput (FILE NAME); 


while (fis.read (readBytes) !=- 1) { 


1 
2 
3 
4  byte[] readBytes- new byte[fis.available()]; 
5 
6.3 


上 面 的 两 部 分 代码 在 实际 使 用 过 程 中 会 遇 到 错误 提示 ,这 是 因为 文件 操作 可 能 会 遇 
到 各 种 问题 而 最 终 导致 操作 失败 ,因此 在 代码 中 应 使 用 try/catch 捕获 可 能 产生 的 异常 。 

在 InternalFileDemo 示例 用 来 演示 在 内 部 存储 器 上 进行 文件 写 入 和 读 取 的 示例 。 
用 户 界面 如 图 8.3 所 示 , 用 户 将 需要 写 入 的 数据 添加 在 EditText 中 ,通过 “ 写 和 文件" 按 
钮 将 数据 写 和 到 /data/data/edu. hrbeu. InternalFileDemo/files/fileDemo. txt 文件 中 。 
如 果 用 户 选择 “追加 模式 ”, 数 据 将 会 添加 到 fileDemo. txt 文件 的 结尾 处 。 通 过 “ 读 取 文 
件 ” 按 钮 ,程序 会 读 取 fileDemo. txt 文件 的 内 容 , 并 显示 在 界面 下 方 的 白色 区 域 中 。 

下 面 给 出 InternalFileDemo 示例 的 核心 代码 。 


К 2: 0 9:14 


InternalFileDemo 


data test 003 


写 入 文件 读 取 文 件 


追加 模式 
datatest 001data test 002 


8.3 InternalFileDemo 用 户 界面 
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1 OnClickListener writeButtonListener- new OnClickListener () ( 
2 @override 

3 public void onClick (View у) { 

4 FileOutputStream fos=null; 

5 try ( 

6 if (appendBox.isChecked () ) ( 

T fos-openFileOutput (FILE МАМЕ, Context .MODE APPEND) ; 
8 }е1зе { 

9 fos-openFileOutput (FILE МАМЕ, Context .MODE PRIVATE); 
10 } 

11 String text=entryText.getText () .toString(); 

1⁄2 fos.write (text .getBytes ()); 

13 labelView.setText (" 文 件 写 人 成 功 , 写 人 长 度 :"+text.length())7 
14 entryText.setText (""); 

15 ) catch (FileNotFoundException е) { 

16 e.printStackTrace(); 

17 ) 

18 catch (IOException е) { 

19 e.printStackTrace () ; 

20 } 

21 finally( 

22 if(fos!-null)( 

23 try ( 

24 fos.flush(); 

25 fos.close(); 

26 ) catch (IOException e)( 

27 e.printStackTrace(); 

28 } 

29 } 

30 } 

31 ) 

32 ); 

33 OnClickListener readButtonListener- new OnClickListener () ( 
34 @ Override 

35 public void onClick (View у) { 

36 displayView.setText (""); 

37 FileInputStream fis-null; 

38 try ( 

39 fis-openFileInput (FILE NAME); 

40 if(fis.available()--O0)( 

41 return; 

42 ) 

43 byte[] readBytes- new byte[fis.available()]; 


44 while (fis.read(readBytes) !=- 1) { 
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45 } 

46 String text- new String (readBytes); 
47 displayView.setText (text) ; 

48 labelView.setText ("文件 读 取 成 功 ,文件 长 度 :"+ text. length 0) ; 
49 ) catch (FileNotFoundException е) { 

50 e.printStackTrace () ; 

51 } 

52 catch (IOException е){ 

53 e.printStackTrace () ; 

54 } 

55 } 

56 }; 


程序 运行 后 ,在 /data/data/edu. hrbeu. InternalFileDemo/files/ 目 录 下 ,找到 了 新 建 
立 的 fileDemo. txt 文件 ,如 图 8.4 所 示 。 从 文件 权限 上 进行 分 析 fileDemo. txt 文件 ,-rw- 
rw- 一 表明 文件 仅 允许 文件 创建 者 和 同 组 用 户 读 写 ,其 他 用 户 无 权 使 用 。 文 件 的 大 小 为 


9 个 字 节 ,保存 的 数据 为 Some data, 


= G> edhabrbewdoternalFbaDemo _ = 2015-04-22 
b he 2015-04-22 


2015-04-22 
fileDemo.t«t 26 2015-04-22 
2015-04-22 


8.4 fileDemo. txt 文件 
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Android 的 外 部 存储 设备 一 般 指 Micro SD F. XEK T-Flash, 是 一 种 广泛 使 用 于 数码 


设备 的 超 小 型 记忆 卡 , 图 8.5 是 东芝 出 品 的 32G Micro SD 卡 。 

Micro SD 卡 适 用 于 保存 大 尺寸 的 文件 或 者 是 一 些 无 须 设 
置 访问 权限 的 文件 。 如 果 用 户 希 望 保 存 录制 的 视频 文件 和 音 
频 文件 ,因为 Android 设备 的 内 部 存储 空间 有 限 , 所 以 使 用 
Micro SD 卡 则 是 非常 合适 的 选择 。 但 如 果 需 要 设置 文件 的 访 
问 权 限 , 则 不 能 够 使 用 Micro SD R, AX Micro SD 卡 使 用 
FAT(File Allocation Table) 文 件 系统 ,不 支持 访问 模式 和 权限 
控制 。Android 的 内 部 存储 器 使 用 的 是 Linux 文件 系统 , 则 可 
通过 文件 访问 权限 的 控制 保证 文件 的 私密 性 。 


8.5 Micro SD + 


Android 模拟 器 支持 SD 卡 的 模拟 ,在 模拟 器 建立 时 可 以 选择 SD 卡 的 容量 ,如 图 8. 6 


所 示 ,在 模拟 器 启动 时 会 自动 加 载 SD 卡 。 正 确 加 载 SD 卡 后 ,SD 卡 中 的 目录 和 文件 被 
映射 到 /mnt/sdcard 目录 下 。 因 为 用 户 可 以 加 载 或 印 载 SD 卡 ,所 以 在 编程 访问 SD 卡 前 
首先 需要 检测 /mnt/sdcard 目录 是 否 可 用 。 如 果 不 可 用 ,说 明 设 备 中 的 SD + GERBER 


载 。 如 果 可 用 , 则 直接 通过 使 用 标准 的 java. io. File 类 进行 访问 。 


SDcardFileDemo 示例 说 明 如 何 将 数据 保存 在 SD 卡 中 。 首 先 通 过 “生产 随机 数列 ” 
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按钮 生成 10 个 随机 小 数 ,然后 通过 * 写 和 人 SD 卡 ” 按 钮 将 生成 的 数据 保存 在 SD 卡 的 根 目 
录 下 ,也 就 是 Android 系统 的 /mnt/sdcard 目录 下 。 
SDcardFileDemo 示例 的 用 户 界 面 如 图 8. 7 所 示 。 


Б: Android Virtual Device (АУС “| 


AVD Name: 
Device: 
Target: 
CPU/ABI: 
Keyboard: 


Skin: 


SD Card: 


Front Camera: 


Back Camera: 


Memory Options: 


Internal Storage: 


Nexus S API 21 


Nexus S (4.0", 480 x 800: hdpi) z) 
Android 5.0.1 - API Level 21 ~ 


ARM (armeabi-v7a) zj 
"lH 


[V] Hardware keyboard present 


No skin | 


None е 

None m 

RAM: 343 VM Heap: 32 

200 MiB +) 

эзше 128 
File: Browse 


8.6 在 AVD 管 理 器 中 的 模拟 SD + 


SDcardFileDemo 示例 运行 后 ,在 每 次 点 


SDcardFileDemo 


生产 随机 数列 


击 “2 


一 个 新 文件 ,文件 名 各 不 相同 ,如 图 8.8 所 示 。 


@ File Explorer 11 


Name 


storage 


4 © sdcard 


© Alarms 
@ Android 

@ DCIM 

© Download 
LOST.DIR 
Movies 

© Music 

E Notifications 
@ Pictures 


» Podcasts. 


ingtones 
3) SdcardFile-1429751846741.t«t 
E) SdcardFile-1429751937994.t«t 


sys 
system 
ueventd.goldfish.rc 


3| ueventd.rc 


2 vendor 


SDcardFileDemo 示例 与 InternalFileDemo 示例 的 核心 代码 比较 相似 ,不 同 之 处 在 于 
E 检 查 ( 代 码 第 7 行 ), 并 使 用 “绝对 目录 十 文件 名 ” 


代码 中 添加 了 /mnt/sdcard H RAFEH 


Size Date 
2015-04-24 
1970-01-01 
2015-03-25 
2015-04-20 
2015-03-25 
2015-03-25 
2015-03-25 
2015-03-25 
2015-03-25 
2015-03-25 
2015-03-25 
2015-03-25 
2015-03-25 

194 2015-04-23 
197 2015-04-23 
2015-04-24 
1970-01-01 
323 1970-01-01 

4389 1970-01-01 

2015-04-24 


9 drxexex 


Р 8.7 SDcardFileDemo 用 户 界 面 


JA SD 卡 ” 按 钮 后 都 会 在 SD 卡 中 生成 


给 外 | 一 | 

Permissions Info 
drexra-x 
drwarws--x 
droan 
drwxrwnt--x 
drwxrwx— 
dwr 
drew 
деги: 
drre- 
drwxrw— 
drann: 
drew 
ү 


drwxr-xr-x 


lwxwxrwx -> /system/vendor 


图 8.8 SD 卡 中 生成 的 文件 


T 
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的 形式 表示 新 建立 的 文件 (代码 第 8 行 ) ,并 在 写 和 文件 前 对 文件 的 存在 性 和 可 写 人 性 进 
行 检查 (代码 第 12 行 )。 为 了 保证 在 SD 卡 中 多 次 写 人 时 文件 名 不 会 重复 ,在 文件 名 中 使 
用 了 唯一 且 不 重复 的 标识 (代码 第 5 行 ) ,这 个 标识 通过 调用 System. currentTimeMillis O K 
数 获得 ,表示 从 1970 年 00:00:00 到 当前 所 经 过 的 毫秒 数 。SDcardFileDemo 示例 的 核心 


代码 如 下 。 
1 private static String randomNumbersString- ""; 
2  OnClickListener writeButtonListener- new OnClickListener () { 
3 @Override 
4 public void onClick (View v) { 
5 String fileName- "SdcardFile- "+ System.currentTimeMillis ()+".txt"; 
6 File dir-new File("/sdcard/"); 
7 if (dir.exists()&& dir.canWrite())( 
8 File newFile- new File (dir.getAbsolutePath () + "/"+ fileName); 
9 FileOutputStream fos-null; 
10 try ( 
11 newFile.createNewFile(); 
12 if (newFile.exists () && newFile.canWrite())( 
13 Ғоз= пем FileOutputStream (newFile); 
14 fos .write (randomNumbersString.getBytes () ) ; 
15 TextView labelView- (TextView)findViewById (R.id.label); 
16 labelView.setText (fileName+ "文件 写 人 sp E"); 
17 } 
18 } catch (IOException е) { 
19 e.printStackTrace (); 
20 ) finally { 
21 if(fos!-null)( 
22 try( 
23 fos.flush(); 
24 fos.close(); 
25 } 
26 catch (IOException е) { } 
27 } 
28 } 
29 k 
30 } 
3 Ы 


程序 在 模拟 器 中 运行 前 ,还 必须 在 AndroidManifest. xml 中 注册 两 个 用 户 权 限 ,分 别 
是 加 载 印 载 文 件 系 统 的 权限 和 向 外 部 存储 器 写 入 数据 的 权限 。AndroidManifest. xml 的 
核心 代码 如 下 。 


L 


«uses- permission android:name- "android.permission.MOUNT UNMOUNT 


ЕТІЕЅҮЅТЕМЅ"> < /uses- permission» 


Pharoia /z A 41 A 3 Z (* 334 ) 


2  «uses-permission android:name- "android.permission.WRITE EXTERNAL | 


STORAGE"» < /uses- permission» 


823 资源 文件 


开发 人 员 除 了 可 以 在 内 部 和 外 部 存储 设备 上 读 写 文件 以 外 ,还 可 以 访问 在 /res/raw 
和 /res/xml 目录 中 的 原始 格式 文件 和 XML 文件, 这些 文件 是 程序 开发 阶段 在 工程 中 保 
存 的 文件 。 

原始 格式 文件 可 以 是 任何 格式 的 文件 ,例如 视频 格式 文件 .音频 格式 文件 .图 像 文件 
或 数据 文件 等 。 在 应 用 程序 编译 和 打包 时 ,/res/raw 目录 下 的 所 有 文件 都 会 保留 原 有 格 
式 不 变 。 而 /res/xml 目录 下 一 般 用 来 保存 格式 化 数据 的 XML 文件 , 则 会 在 编译 和 打包 
时 将 XML 文件 转换 为 二 进 制 格式 ,用 以 降低 存储 器 空间 占用 率 和 提高 访问 效率 ,在 应 用 
程序 运行 的 时 候 会 以 特殊 的 方式 进行 访问 。 

ResourceFileDemo 示例 演示 了 如 何在 程序 运行 时 访问 资源 文件 。 当 用 户 点 击 “ 读 取 
原始 文件 ”按钮 时 ,程序 将 读 取 /res/raw/raw_file. txt 文件 ,并 将 内 容 显 示 在 界面 上 ,如 
图 8.9(a) 所 示 。 当 用 户 点 击 “ 读 取 XML 文件 ”按钮 时 ,程序 将 读 取 /res/xml/people. xml 
文件 ,也 将 内 容 显示 在 界面 上 ,如 图 8.9(b) 所 示 。 


ça ü 9:39 


ResourceFileDemo ResourceFileDemo 


读 取 原 始 文件 读 取 XML 文 件 ”清除 显示 读 取 原 始 文件 读 取 XML 文 件 ARER 


(a) 读 取 原始 文件 (b) 读 取 XML 文 件 
图 8.9 ResourceFileDemo 用 户 界面 


读 取 原 始 格式 文件 首先 需要 调用 getResource O 函数 获得 资源 实例 ,然后 通过 调用 
资源 实例 的 openRawResource() 函 数 ,以 二 进 制 流 的 形式 打开 指定 的 原始 格式 文件 。 在 
读 取 文件 结束 后 ,调用 close() 函 数 关闭 文件 流 。 

ResourceFileDemo 示例 中 读 取 原 始 格 式 文件 的 核心 代码 如 下 。 

Resources resources= this.getResources () ; 


InputStream inputStream=null; 


try { 


inputStream= resources .openRawResource (R.raw.raw file); 


while (inputStream. read (reader) !=- 1) { 
} 


* 
3 
4 
5 byte[] reader=new byte[inputStream.available()]; 
6 
7 
8 displayView.setText (new String (reader, "utf- 8")); 
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9 } catch (IOException e)( 


10 Log.e ("ResourceFileDemo", e.getMessage (), е); 
11 } finally { 

12 if(inputstream!=null){ 

13 try { 

14 inputStream.close|(); 

15 } 

16 catch (IOException е){} 

17 } 

18 } 


代码 第 8 行 的 new String(reader,"utf-8") ,表示 以 UTF-8 的 编码 方式 从 字 节 数组 
中 实例 化 一 个 字符 串 。 如 果 程 序 开发 人 员 需 要 新 建 /res/raw/raw_file. txt 文件 , 则 需要 
选择 使 用 UTF-8 编码 方式 ,否则 程序 运行 时 会 产生 乱码 。 选 择 的 方法 是 在 raw_file. txt 
文件 上 右 击 ,选择 Properties 打开 raw. file. txt 文件 的 属性 设置 框 ,然后 在 Resource 栏 下 
的 Text file encoding 中 选择 “Other: UTF-8”, 如 图 8. 10 所 示 。 


[type filter text || Resource cot 
пеки Path: fResourceFileDemo/res/raw/raw. file tt 
Run/Debug Settings PER porai 
Location:  CAUsers\jce\Desktop\SER (RURE YA) \ResourceFileDemo\res\rawraw.file.bt 
Size: 92 bytes 
Last modified: 2011 年 10 月 23 日 下 午 9:04:02 
Attributes: 
E Read-only 
[IS Archive 
Derived 
Text file encoding 


© Default (inherited from container: СВК) 
@ Other: v 


Restore Defaults | — Apply 
© [ e ][ < 


8.10 选择 raw file. txt 文件 编码 方式 


/res/ xml 目录 下 的 XML 文件 与 其 他 资源 文件 有 所 不 同 ,程序 开发 人 员 不 能 够 以 流 
的 方式 直接 读 取 ,其 主要 原因 在 于 Android 系统 为 了 提高 读 取 效 率 ,减少 占用 的 存储 空 
间 ,将 XML 文件 转换 为 一 种 高 效 的 二 进 制 格式 。 

为 了 说 明 如 何在 程序 运行 时 读 取 /res/xml 目录 下 的 XML 文件 ,首先 在 /res/xml 目 
录 下 创建 一 个 名 为 people. xml 的 文件 。XML 文件 定义 了 多 个 二 person 记 元 素 ,每 个 
二 person 祖 元 素 都 包含 三 个 属性 name age 和 height, 分 别 表 示 姓 名 、 年 龄 和 身高 。 

/res/ xml/people. xml 文件 代码 如 下 。 


1 «people» 
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Š «person name- "2 ЖЖ" age= "21" height="1.81" /> 

3 «person name- "Е ЖЖ" age= "25" height- "1.76" /> ы 

4 «person папе= "ЖЖ" age= "20" height- "1.69" /> 3 ud 
5  «/people» Dii 


读 取 XML 格式 文件 ,首先 通过 调用 资源 实例 的 getXml() 函数 ,获取 XML 解析 器 
XmlPullParser。XmlPullParser 是 Android 平台 标准 的 XML 解析 器 ,这 项 技术 来 自 一 
个 开源 的 XML 解析 API 项 目 XMLPULL。 

ResourceFileDemo 示例 中 关于 读 取 XML 文件 的 核心 代码 如 下 。 


1  XmlPullParser parser- resources .getXml (R.xml.people); 

2  Stringmsg-""; 

3 try ( 

4 while (parser.next()!-XmlPullParser.END DOCUMENT) { 

5 String people- parser.getName () ; 

6 String name-null; 

T String age=null; 

8 String height-null; 

9 if((people!-null)&& people .equals ("person") ) { 

10 int count=parser.getAttributeCount () ; 

14 for (int i=0; i «count; i++){ 

12 String attrName=parser.getAttributeName (i); 

13 String attrValue=parser.getAttributeValue (1); 

14 if((attrName!-null)&& attrName.equals ("name") ) { 
15 name=attrValue; 

16 ) else if ((attrName!=nu11)&& attrName.equals ("age") ) ( 
17 age=attrValue; 

18 } else if ((attrName!=nu11)&& attrName.equals ("height")){ 
19 height- attrValue; 

20 } 

21 } 

22 if((name!=null)&&(age!=null)&&(height!=nul1))( 

23 msg+ = "姓名 :" name ", Й :"+age+ ", £r р :"+height+ "Nn"; 
24 } 

25 k 

26 } 


21 } catch (Exception е) { 

28 Log.e("ResourceFileDemo", e.getMessage(), е); 
29 ] 

30 displayView.setText (msg); 


代码 第 1 行 通过 资源 实例 的 getXml O 函数 获取 XML 解析 器 。 第 4 行 的 parser 
. next() 方 法 可 以 获取 高 等 级 的 解析 事件 ,并 通过 对 比 确定 事件 类 型 ,XML 事件 类 型 参 
考 表 8. 2。 
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表 8.2 XmlPullParser 的 XML 事件 类 型 


事件 类 型 说 M 
START_TAG 读 取 到 标签 开始 标志 
TEXT 读 取 文 本 内 容 
END_TAG 读 取 到 标签 结束 标志 


END_DOCUMENT 文档 末尾 


第 5 行使 用 getName() 函 数 获取 元 素 的 名 称 , 第 10 行使 用 getAttributeCount O FR 
数 获取 元 素 的 属性 数量 ,第 12 行 通过 getAttributeName O 函数 得 到 属性 名 称 。 最 后 在 
第 14 行 到 第 19 行 代码 中 ,通过 分 析 属 性 名 获取 正确 的 属性 值 ,并 在 第 23 行将 属性 值 整 
理 成 需要 显示 的 信息 。 
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831 SQLite 数据库 


SQLite 是 一 个 2000 年 由 D. Richard Hipp 开发 的 开源 租 入 式 关系 数据 库 。 自 从 出 
现 商 业 应 用 程序 以 来 ,数据 库 就 一 直 是 应 用 程序 的 主要 组 成 部 分 ,数据 库 的 管理 系统 也 
比较 庞大 和 复杂 , 且 会 占用 较 多 的 系统 资源 。 随 着 嵌入 式 应 用 程序 的 大 量 出 现 , 一 种 新 
型 的 轻 量 级 数据 库 SQLite 也 随 之 产生 。SQLite 数据 库 比 传统 数据 库 更 适合 用 于 散人 入 式 
系统 ,因为 它 占 用 资源 少 .运行 高 效 可 靠 , 可 移植 性 强 , 并 且 提 供 了 零 配 置 (zero- 
configuration) 运 行 模式 。 

SQLite 数据 库 的 优势 在 于 其 谋 入 到 使 用 它 的 应 用 程序 中 。 这 样 不 仅 提高 了 运行 效 
率 , 而 且 屏 蔽 了 数据 库 使 用 和 管理 的 复杂 性 ,应 用 程序 仅 做 最 基本 的 数据 操作 ,其 他 操作 
则 交 给 进程 内 部 的 数据 库 引 擎 完成 。 同 时 ,因为 客户 端 和 服务 器 在 同一 进程 空间 运行 ， 
所 以 完全 不 需要 进行 网 络 配置 和 管理 ,减少 了 网 络 调 用 所 造成 的 额外 开销 。 以 这 样 方式 
简化 的 数据 库 管 理 过 程 ,使 应 用 程序 更 加 易于 部 署 和 使 用 ,程序 开发 人 员 仅 需要 把 
SQLite 数据 库 正 确 编译 到 应 用 程序 中 即 可 。 

SQLite 数据 库 采 用 了 模块 化 设计 ,模块 将 复杂 的 查询 过 程 分 解 为 细小 的 工作 进行 处 
H. SQLite 数据 库 由 8 个 独立 的 模块 构成 ,这 些 独 立 模块 又 构成 了 三 个 主要 的 子 系统 。 
SQLite 数据 库 体系 结构 如 图 8. 11 所 示 。 

接口 由 SQLite C API 组 成 ,因此 无 论 是 应 用 程序 .脚本 ,还 是 库 文 件 , 最 终 都 是 通过 
接口 与 SQLite 交互 。 

在 编译 器 中 ,分 词 器 和 分 析 器 对 SQL 语句 进行 语法 检查 .然后 把 SQL 语句 转化 为 便 
于 底层 处 理 的 分 层 数据 结构 ,这 种 分 层 的 数据 结构 称 为 “语法 树 ”。 然 后 把 语法 树 传 给 代 
码 生 成 器 进行 处 理 , 生 成 一 种 用 于 SQLite 的 汇编 代码 ,最 后 由 虚拟 机 执行 。 

SQLite 数据 库 体系 结构 中 最 核心 的 部 分 是 虚拟 机 ,也 称 为 虚拟 数据 库 引 擎 (Virtual 
Database Engine, VDBE)。 与 Java 虚拟 机 相似 ,虚拟 数据 库 引擎 用 来 解释 并 执行 字 节 代 
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Maous iis (узж) 


接口 - BH} 
тй 
| 编译 器 分 词 器 页 缓存 _ 
i | 
分 析 器 操作 系统 接口 

i 

PORS 代码 生成 器 | 
数据 库 


8.11 SQLite 数据 库 体 系 结构 


码 。 虚 拟 数据 库 引 擎 的 字 节 代码 由 128 个 操作 码 构成 ,这 些 操作 码 主要 用 以 对 数据 库 进 
行 操作 ,每 一 条 指令 都 可 以 完成 特定 的 数据 库 操 作 ,或 以 特定 的 方式 处 理 栈 的 内 容 。 

后 端 由 B- 树 .页 缓存 和 操作 系统 接口 构成 ,B- 树 和 页 缓存 共同 对 数据 进行 管理 。B- 
树 的 主要 功能 就 是 索引 , 它 维护 着 各 个 页 面 之 间 复 杂 的 关系 ,便于 快速 找到 所 需 数据 。 
页 缓存 的 主要 作用 是 通过 操作 系统 接口 在 B- 树 和 磁盘 之 间 传 递 页 面 。 

SQLite 数据 库 具 有 很 强 的 移植 性 ,可 以 运行 在 Windows、Linux、BSD、Mac OS 和 一 
些 商 用 Unix 系统 ,比如 Sun 的 Solaris 或 IBM 的 AIX。 同 样 , 也 可 以 工作 在 许多 舱 入 式 
操作 系统 下 ,比如 QNX, VxWorks,Palm OS.Symbin 和 Windows CE, SQLite 的 核心 大 
约 有 3 万 行 标准 C 代码 ,因为 模块 化 的 设计 使 这 些 代 码 非常 易于 理解 。 
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在 Android 系统 中 ,每 个 应 用 程序 的 SQLite 数据 库 被 保存 在 各 自 的 /data/data/ 
<package пате2> /databases 目录 下 。 默 认 情 况 下 ,所 有 数据 库 都 是 私有 的 , 仅 允 许 创 建 
数据 库 的 应 用 程序 访问 ,如 果 需 要 共享 数据 库 则 可 以 使 用 ContentProvider。 虽 然 应 用 程 
序 完全 可 以 在 代码 中 动态 建立 SQLite 数据 库 . 但 使 用 命令 行 手工 建立 和 管理 数据 库 仍 
然 是 非常 重要 的 内 容 , 对 于 调试 使 用 数据 库 的 应 用 程序 非常 有 用 。 

手动 建立 数据 库 指 的 是 使 用 sqlite3 工具 ,通过 手工 输入 命令 行 完 成 数据 库 的 建立 过 
程 。sqlite3 是 SQLite 数据 库 自 带 的 一 个 基于 命令 行 的 SQL 命令 执行 工具 ,并 可 以 显示 
命令 执行 结果 。Android SDK 的 tools 目录 有 sqlite3 工具 ,同时 ,该 工具 也 被 集成 在 
Android 系统 中 。 

下 面 的 内 容 将 介绍 如 何 连 接 到 模拟 器 中 的 Linux 系统 ,并 在 Linux 系统 中 启动 
sqlite3 工具 ,在 Android 程序 目录 中 建立 数据 库 和 数据 表 , 并 使 用 命令 在 数据 表 中 添加 、 
修改 和 删除 数据 。 
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开发 人 员 可 以 使 用 adb shell 命令 连接 到 模拟 器 的 Linux 系统 ,在 Linux 命令 提示 符 
下 输入 sqlite3 可 启动 sqlite3 工具 。 启 动 sqlite3 后 会 显示 SQLite 的 版 本 信息 ,显示 内 容 
下 面 所 示 。 


工 #sqlite3 

Ж SQLite уегѕіоп 3.6.22 

3 Enter ".help" for instructions 

4 Enter SQL statements terminated with a ";" 
5 sqlite> 


在 启动 sqlite3 工具 后 HERMA HEH sqlite 二 ,表示 用 户 进 入 SQLite 数据 库 交互 
模式 ,此 时 可 以 输入 命令 建立 .删除 或 修改 数据 库 的 内 容 。 正 确 退出 sqlite3 工具 的 方法 
是 使 用 . exit 命令 : 

1 sqlite> .exit 

2 # 

原则 上 ,每 个 应 用 程序 的 数据 库 都 保存 在 各 自 的 /data/data/ 过 package name 2 / 
databases 目录 下 。 但 如 果 使 用 手工 方式 建立 数据 库 , 则 必须 手工 建立 数据 库 目录 ,目前 
版 本 无 须 修 改 数据 库 目录 的 权限 。 


1 #mkdir databases 

2 #15 -1 

3  drwxrwxrwx root root 2011- 09- 19 15:43 databases 
4 drwxr-xr-x system system 2011-09-19 15:31 lib 

5 4 


在 SQLite 数据 库 中 ,每 个 数据 库 保 存在 一 个 独立 的 文件 中 。 使 用 "sqlite3 十 文件 名 ” 
的 方式 打开 数据 库 文件 ,如 果 指 定 的 文件 不 存在 ,sqlite3 工具 则 自动 创建 新 文件 。 下 面 
的 代码 将 创建 名 为 people 的 数据 库 ,在 文件 系统 中 将 产生 一 个 名 为 people. db 的 数据 库 
文件 。 
#sqlite3 people.db 


SQLite version 3.6.22 


Enter ".help" for instructions 


оо м б 


Enter SQL statements terminated with a ";" 


10 sqlite> 


下 面 的 代码 在 数据 库 中 ,构造 了 一 个 名 为 peopleinfo 的 表 , 使 用 create table 命令 ， 
关系 模式 为 peopleinfo(_id，name，age，height) 。 表 包含 四 个 属性 ，id 是 整 型 的 主键 ; 
name 表示 姓名 ,字符 型 ,not null 表示 属性 值 一 定 要 填写 ,不 可 以 为 空 值 ;age 表示 年 龄 ， 
整数 型 ;height 表示 身高 , 浮 点 型 。 

1 sqlite>create table peopleinfo 


z -> (_id integer primary key autoincrement, 


3 ..> name text not null, 
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4 ..> аде integer, 
5 -.2height float); 
6  sglite» 


为 了 确认 数据 表 是 否 创建 成 功 ,可 以 使 用 . tables 命令 ,显示 当前 数据 库 中 的 所 有 表 。 
从 下 面 的 代码 中 可 以 观察 到 ,当前 的 数据 库 中 仅 有 一 个 名 为 peopleinfo 的 表 。 


1  sqlite» .tables 

2  peopleinfo 

3 sqlite> 

当然 ,也 可 以 使 用 . schema 命令 查看 建立 表 时 使 用 的 SQL 命令 。 如 果 当 前 数据 库 中 
包含 多 个 表 , 则 可 以 使 用 [. schema 表 名 ] 的 形式 ,显示 指定 表 的 建立 命令 。 
sqlite> .Schema 
CREATE TABLE peopleinfo 


( id integer primary key autoincrement, 
name text not null, 

age integer, 

height float); 


чо оеш моь 


sqlite> 

下 一 步 是 向 peopleinfo 表 中 添加 数据 ,使 用 insert into: values 命令 。 在 下 面 的 代码 
成 功 运行 后 ,数据 库 的 peopleinfo 表 将 有 三 条 数据 ,内 容 如 表 8.3 所 示 。 因 为 _id 是 自动 
增加 的 主键 ,因此 在 输入 null 后 ,SQLite 数据 库 会 自动 填写 该 项 的 内 容 。 
sqlite>insert into peopleinfo values (null, 'Tom',21,1.81); 


1 
2 sqlite>insert into peopleinfo values (null, 'Jim',22,1.78); 
Е; sqlite>insert into peopleinfo values (null, 'Lily',19,1.68); 


3 8.3  peopleinfo 表 内 容 


ла пате age height 
1 Tom 21 1. 81 
2 Jim 22 1.78 
3 Lily 19 1.68 


在 数据 添加 完毕 后 ,使 用 select 命令 ,显示 peopleinfo 数据 表 中 的 所 有 数据 信息 , 命 
令 格式 为 Lselect 属性 from 表 名 ]。 下 面 的 代码 用 来 显示 peopleinfo 表 的 所 有 数据 。 
select * from peopleinfo; 


1 

2 1|Tom|21|1.81 
3  2|Jim|22|1.78 
4 

5 


3|Lily|19|1.68 
sqlite> 
上 面 的 查询 结果 看 起 来 不 是 很 直观 ,使 用 表格 方式 显示 更 符合 习惯 ,因此 可 以 使 用 
. mode 命令 更 改 结果 输出 格式 。. mode 命令 除了 支持 常见 的 column 格式 外 ,还 支持 csv 
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格式 .html 格式 insert 格式 line 格式 \list 格式 tabs ЖЖП tel 格式。 下 面 使 用 column 
格式 显示 peopleinfo 数据 表 中 的 数据 信息 。 


1 
2 
3 
4 
5 
6 


sqlite> .mode column 
sqlite> select * from peopleinfo; 


1 Тот 21 1.81 
2 Jim 22 1.78 
3 Lily 19 1.68 
sqlite> 


更 新 数据 可 以 使 用 update 命令 ,命令 格式 为 [update KA set 属性 ==" 新 值 " where 
条 件 ]。 更 新 数据 后 ,同样 使 用 select 命令 显示 数据 ,确定 数据 是 否 正确 更 新 。 下 面 的 代 
码 将 Lily 的 身高 更 新 为 1. 88。 


Yone UNBE 


sqlite> update peopleinfo set height=1.88 where name= "Lily"; 
sqlite>select * from peopleinfo; 


select * from peopleinfo; 


1 Тош 21 1.81 
2 Jim 22 1.78 
3 Lily 19 1.88 
sqlite> 


删除 数据 可 以 使 用 delete 命令 ,命令 格式 为 [delete from 表 名 where 条 件 ]。 下 面 的 
代码 将 _id 为 3 数据 从 表 peopleinfo 中 删除 。 


со 0 ww P 


sqlite> delete from peopleinfo where _ id= 3; 
sqlite>select * from peopleinfo; 


select * from peopleinfo; 


1 Тош 21 1.81 
2 Jim 22 1.78 
sqlite» 


sqlite3 工具 还 支持 很 多 命令 ,可 以 使 用 . help 命令 查询 sqlite3 的 命令 列表 ,也 可 以 参 
考 表 8.4, 这 里 就 不 再 详细 介绍 了 。 


表 8.4 sqlite3 命令 列表 


m 号 命 令 说 明 
1 . bail ON| OFF 遇 到 错误 是 停止 ,默认 为 OFF 
2 . databases 显示 数据 库 名 称 和 文件 位 置 
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续 表 
ж 号 命 + 说 明 
3 . dump ?TABLE? ... 将 数据 库 以 SQL 文本 形式 导出 
4 .echo ON|OFF 开启 和 关闭 回 显 
5 „exit 退出 
6 .explain ON| OFF. a r 
7 . header(s) ON|OFF 开启 或 关闭 标题 显示 
ë . help 显示 帮助 信息 
9 . import FILE TABLE 将 数据 从 文件 导入 表 
10 . indices TABLE 显示 表 中 所 有 的 列 名 
11 .load FILE ?ENTRY? 导入 扩展 库 
12 . mode MODE ?TABLE? 设置 输入 格式 
13 .nullvalue STRING 打印 时 使 用 STRING 代替 NULL 
14 . output FILENAME 将 输入 保存 到 文件 
15 . output stdout 将 输入 显示 在 屏幕 上 
16 .prompt MAIN CONTINUE | 替换 标准 提示 符 
17 . quit 退出 
18 .read FILENAME 在 文件 中 执行 SQL 语句 
19 . schema ?T ABLE? 显示 表 的 创建 语句 
20 . separator STRING 更 改 输入 和 导入 的 分 隔 符 
21 . show 显示 当前 设置 变量 值 
22 .tables ?PATTERN? 显示 符合 匹配 模式 的 表 名 
23 . timeout MS 尝试 打开 被 锁定 的 表 MS 毫秒 
24 . timer ON| OFF 开启 或 关闭 CPU 计时 器 
25 .width NUM NUM... 设置 column 模式 的 宽度 
833 代码 建 库 


在 代码 中 动态 建立 数据 库 是 比较 常用 的 方法 。 例 如 ,在 程序 运行 过 程 中 , 当 需 要 进 
行 数据 库 操作 时 ,应 用 程序 会 首先 尝试 打开 数据 库 , 此 时 如 果 数 据 库 并 不 存在 ,程序 则 会 
自动 建立 数据 库 , 然 后 再 打开 数据 库 。 

在 编程 实现 时 ,一 般 将 所 用 对 数据 库 的 操作 都 封装 在 一 个 类 中 ,因此 只 要 调用 这 个 
类 ,就 可 以 完成 对 数据 库 的 添加 、 更 新 、 删 除 和 查询 等 操作 。 下 面 内 容 是 DBAdapter 类 的 
部 分 代码 ,封装 了 数据 库 的 建立 、 打 开 和 关闭 等 操作 。 
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1 public class DBAdapter { 


2 private static final String DB NAME- "people.db"; 
3 private static final String DB TABLE- "peopleinfo"; 
4 private static final int DB VERSION- 1; 

5 

6 public static final String KEY_ID=" id"; 

7 public static final String KEY NAME- "name"; 

8 public static final String KEY AGE- "age"; 

9 public static final String KEY HEIGHT- "height"; 
10 

11 private SQLiteDatabase db; 

12 private final Context context; 

43 private DBOpenHelper dbOpenHelper; 

14 

15 private static class DBOpenHelper extends SQLiteOpenHelper {} 
16 

17 public DBAdapter (Context _context) { 

18 context=_context; 

19 ) 

20 

21 public void open()throws SQLiteException ( 

22 арорепНе1рег= пем DBOpenHelper (context, DB NAME, null, DB VERSION); 
23 try ( 

24 db= dbopenHelper.getWritableDatabase (); 
25 )catch (SQLiteException ех) { 

26 db= dbOpenHelper.getReadableDatabase () ; 
27 } 

28 } 

29 

30 public void close () ( 

31 if(db!-null)( 

32 db.close(); 

33 db-null; 

34 ) 

35 1 

36 ) 


从 代码 的 第 2 行 到 第 9 行 可 以 看 出 ,在 DBAdapter 类 中 首先 声明 了 数据 库 的 基本 信 
息 , 包 括 数 据 库 的 文件 名 称 、 表 名 称 和 版 本 号 ,以 及 数据 库 表 的 属性 名 称 。 从 这 些 基 本 信 
息 上 不 难 发 现 ,这 个 数据 库 与 前 一 小 节 手 动 建立 的 数据 库 是 完全 相同 的 。 

代码 第 11 行 声明 了 SQLiteDatabase 的 实例 。SQLiteDatabase 类 封装 了 较 多 的 方 
法 ,用 以 建立 删除 数据 库 ,执行 SQL 命令 ,对 数据 进行 管理 等 工作 。 

代码 第 13 行 声 明了 一 个 非常 重要 的 帮助 类 SQLiteOpenHelper, 这 个 帮助 类 可 以 畏 
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助 建立 ,更 新 和 打开 数据 库 。 虽 然 在 代码 第 21 行 定义 了 open() 函 数 用 来 打开 数据 库 , 但 
open С) 函数 中 并 没有 任何 对 数据 库 进 行 实 际 操作 的 代码 ,而 是 调用 了 
SQLiteOpenHelper 类 的 getWritableDatabaseO 1 getReadableDatabaseCO 函数 。 这 
两 个 函数 会 根据 数据 库 是 否 存在 .版 本 号 和 是 否 可 写 等 情况 ,决定 在 返回 数据 库 实例 前 ， 

在 代码 第 30 行 的 close() 函 数 中 ,调用 SQLiteDatabase 实例 的 close() 方 法 关闭 数据 
库 。 这 是 代码 中 唯一 一 处 直接 调用 SQLiteDatabase 实例 的 方法 。SQLiteDatabase 中 也 
封装 了 打开 数据 库 的 函数 openDatabases() 和 创建 数据 库 函 数 openOrCreateDatabases CO , 
因为 代码 中 使 用 了 帮助 类 SQLiteOpenHelper, 从 而 避免 直接 调用 SQLiteDatabase 的 打 
开 和 创建 数据 库 的 方法 ,简化 了 数据 库 打 开 过 程 中 繁琐 的 逻辑 判断 过 程 。 

DBOpenHelper 继承 了 帮助 类 SQLiteOpenHelper. 重 载 了 onCreate CO 函数 和 
onUpgrade() 函 数 , 代 码 如 下 。 


private static class DBOpenHelper extends SQLiteOpenHelper { 
2 public DBOpenHelper (Context context, String name, CursorFactory 


factory, int version)( 


3 super(context, name, factory, version); 

4 ) 

5 private static final String DB CREATE- "create table "+ 

6 DB TABLE+ " ("+ KEY_ID+" integer primary key autoincrement, "+ 

7 KEY МАМЕ+ " text not null, "+KEY АСЕ+" integer, KEY НЕІСНТ+ 

""f1gat);"; 

8 

9 @ Override 

10 public void onCreate(SQLiteDatabase db)( 

11 .db.execSQL(DB CREATE); 

12 } 

13 

14 @ Override 

15 public void onUpgrade (SQLiteDatabase _db, int oldVersion, int _ 
newVersion) { 

16 _db.execSQL ("DROP TABLE IF EXISTS "+DB TABLE); 

17 onCreate( db); 

18 } 

49: ў 


代码 的 第 5 行 到 第 7 行 是 创建 表 的 SQL 命令 。 代 码 第 10 行 和 第 15 行 分 别 重 载 了 
onCreate() 函数 和 onUpgrade O PR Zt . ix d Ж SQLiteOpenHelper 类 必须 重 载 的 两 个 
函数 。onCreate() 函数 在 数据 库 第 一 次 建立 时 被 调用 ,一 般 用 来 创建 数据 库 中 的 表 , 并 完 
成 初始 化 工作 。 在 代码 第 11 行 中 ,通过 调用 SQLiteDatabase 实例 的 execSQL() 方 法 , 执 
行 创 建 表 的 SQL 命令 。onUpgrade() 函数 在 数据 库 需 要 升级 时 被 调用 ,一 般 用 来 删除 旧 
的 数据 库 表 ,并 将 数据 转移 到 新 版 本 的 数据 库 表 中 。 在 代码 第 16 行 和 第 17 行 中 ,为 了 
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简单 起 见 , 并 没有 做 任何 数据 转移 ,而 仅仅 删除 原 有 的 表 后 建立 新 的 数据 表 。 

程序 开发 人 员 不 应 直接 调用 onCreate ( ) 和 onUpgrade ( ) 函数 ,而 应 由 
SQLiteOpenHelper 类 来 决定 何 时 调用 这 两 个 函数 。SQLiteOpenHelper Ж 的 
getWritableDatabase ( ) 函数 和 getReadableDatabase C) в #3 nf LJ E dz js] JH О РА Zi. 
getWritableDatabase() 函 数 用 来 建立 或 打开 可 读 写 的 数据 库 实例 ,一 旦 函数 调用 成 功 ， 
数据 库 实例 将 被 缓存 ,在 需要 使 用 数据 库 实例 时 就 可 以 调用 这 个 方法 获取 数据 库 实例 ， 
务必 在 不 使 用 时 调用 close() 函 数 关闭 数据 库 。 如 果 保 存 数据 库 文件 的 磁盘 空间 已 满 , 调 
用 getWritableDatabase C ) 函数 则 无 法 获得 可 读 写 的 数据 库 实例 ,这 时 可 以 调用 
getReadableDatabase O 函数 ,获得 一 个 只 读 的 数据 库 实例 。 

当然 ,如 果 程 序 开 发 人 员 不 希望 使 用 SQLiteOpenHelper 类 ,也 可 以 直接 使 用 SQL 
命令 建立 数据 库 。 首 先 调用 openOrCreateDatabases() 函数 创建 数据 库 实 例 , 然 后 调用 
execSQLO 函数 执行 SQL 命令 ,完成 数据 库 和 数据 表 的 建立 过 程 ,其 示例 代码 如 下 。 


private static final String DB CREATE- "create table "+ 
DB TABLE+ " ("+ KEY_ID+" integer primary key autoincrement, "+ 
KEY NAME+" text not null, "+КЕҮ AGE+" іпседег,"+ KEY HEIGHT+" float);"; 


db.openOrCreateDatabases (DB NAME, context.MODE PRIVATE, null) 


1 

2 

3 

4 public void create () { 
5 

6 db.execSQL(DB CREATE); 
7 


} 


834 数据 操作 


数据 操作 指 的 是 对 数据 的 添加 \ 删 除 .查找 和 更 新 操作 ,虽然 程序 开发 人 员 
完全 可 以 通过 执行 SQL 命令 完成 数据 操作 ,但 这 里 仍然 推荐 使 用 Android 提供 的 专用 
类 和 方法 ,这 些 类 和 方法 的 使 用 更 加 简洁 方便。 

为 了 使 DBAdapter 类 支持 数据 添加 、 删 除 、 更 新 和 查找 等 功能 ,在 DBAdapter 类 中 
增加 下 面 的 函数 。 其 中 ,insert(People people) 用 来 添加 一 条 数据 ,queryAllData() 用 来 
获取 全 部 数据 ,queryOneData(long id) 根 据 id 获取 一 条 数据 ,deleteAllData() 用 来 删除 
全 部 数据 , deleteOneData(long id) 根据 id 删除 一 条 数据 , updateOneData (long id ， 
People people) 根 据 id 更 新 一 条 数据 。 

public class DBAdapter ( 


public long insert (People people) {} 
public long deleteA11Data () ( } 


1 

3 

4 public long deleteOneData (long іа) { } 

5 public People [] queryA11Data () {} 

6 public People [] queryOneData (long іа) {} 

7 public long updateOneData (long id , People people) { } 
8 
a 


private People[] ConvertToPeople (Cursor cursor) {} 
36 J 
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ConvertToPeople(Cursor cursor) 是 私有 函数 ,作用 是 将 查询 结果 转换 自 定义 的 
People 类 实例 。People 类 包含 4 个 公共 属性 ,分 别 为 ID、Name、Age 和 Height, 对 应 数 
据 库 中 的 4 个 属性 值 。 重 载 toString(O 〇 函数 ,主要 是 便于 界面 显示 的 需要 。 


People 类 的 代码 如 下 。 

1 public class People { 

2 public int ID-- 1; 

3 public String Name; 

4 public int Age; 

5 public float Height; 

6 

7 @override 

8 public String toString()( 

9 String result-""; 

10 resultt- "ID:"-this.IDt","; 

11 гези1с+="# Ж :"+this.Name+ ","; 
12 年 龄 :"+this.Rge+" "; 
13 resultt- "身高 :"+this.Height+ ","; 
14 return result; 

15 ) 

16 } 


SQLiteDatabase 类 的 公有 函数 insert() .delete() ,update() 和 query() 封 装 了 执行 添 
加 、 删 除 .更 新 和 查询 功能 的 SQL 命令 。 下 面 分 别 介绍 如 何 使 用 SQLiteDatabase 类 的 公 
有 函数 ,完成 数据 的 添加 、 删 除 、 更 新 和 查询 等 操作 。 


1. 添加 功能 


为 了 添加 一 条 新 数据 ,首先 构造 一 个 ContentValues 实例 ,然后 调用 ContentValues 
实例 的 put () 方 法 ,将 每 个 属性 的 值 写 入 到 ContentValues 实例 中 ,最 后 使 用 
SQLiteDatabase 实例 的 insert BR Ж .1% ContentValues 实例 中 的 数据 写 人 指定 的 数据 
表 中 。insert() 函 数 的 返回 值 是 新 数据 插入 的 位 置 , 即 ID 值 。ContentValues 类 是 一 个 
数据 承载 容器 ,主要 用 来 向 数据 库 表 中 添加 一 条 数据 。 


public long insert (People people) { 
ContentValues newValues- new ContentValues () ; 


newValues.put(KEY NAME, people.Name); 
newValues.put(KEY AGE, people.Age); 
newValues.put(KEY HEIGHT, people.Height); 


return db.insert(DB TABLE, null, newValues); 
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$ 
Ж 4 行 代码 向 ContentValues 实例 newValues 中 添加 一 个 名 称 / 值 对 ,put() 函数 的 
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第 1 个 参数 是 名 称 , 第 2 个 参数 是 值 。 第 8 行 代码 的 insert() 函数 中 ,第 1 个 参数 是 数据 
表 的 名 称 ; 第 2 个 参数 是 替换 数据 , 当 第 3 个 参数 中 的 数据 为 空 时 使 用 ;第 3 个 参数 是 需 
要 向 数据 库 表 中 添加 的 数据 。 


2. 删除 功能 


删除 数据 比较 简单 ,只 需要 调用 当前 数据 库 实 例 的 delete() 函 数 ,并 指明 表 名 称 和 删 
除 条 件 即 可 。 
public long deleteA11Data () ( 


return db.delete (DB TABLE, null, пи11); 
) 


public long deleteOneData (long id) ( 


1 
2 
3 
4 
5 
6 return db.delete(DB TABLE, KEY ID+ "= "+ id, null); 
7 


} 


deleteO И 1 个 参数 是 数据 表 名 称 ,第 2 个 参数 是 删除 条 件 。 在 第 2 行 代码 
中 ,删除 条 件 为 null, 表 示 删 除 表 中 的 所 有 数据 。 代 码 第 6 行 则 指明 需要 删除 数据 的 id 
值 , 因 此 deleteOneData O 函数 仅 删除 一 条 数据 ,此 时 delete() 函 数 的 返回 值 表 示 被 删除 
的 数据 数量 。 


3. 更 新 功能 


更 新 数据 同样 要 使 用 ContentValues 实例 ,首先 构造 ContentValues 实例 ,然后 调用 
put OO 函数 将 属性 值 写 人 到 ContentValues 实例 中 ,最 后 使 用 SQLiteDatabase 的 update CO PR 
数 ,并 指定 数据 的 更 新 条 件 。 


public long updateOneData (long id, People people) ( 
ContentValues updateValues- new ContentValues (); 
updateValues.put(KEY NAME, people.Name); 
updateValues.put(KEY AGE, people.Age); 


1 

2 

3 

4 

5 updateValues.put(KEY HEIGHT, people.Height); 

6 

7 return db.update (DB TABLE, updateValues, KEY ID+"="+id, null); 
8 


) 
在 代码 的 第 7 行 中 ,update() 函数 的 第 1 个 参数 表示 数据 表 的 名 称 , 第 2 个 参数 是 更 
新 条 件 。update() 函数 的 返回 值 表示 数据 库 表 中 被 更 新 的 数据 数量 。 
4. 查询 功能 
介绍 查询 功能 前 , 先 要 介绍 一 下 Cursor 类 。 在 Android 系统 中 ,数据 库 查询 结果 的 


返回 值 并 不 是 数据 集合 的 完整 拷贝 ,而 是 返回 数据 集 的 指针 ,这 个 指针 就 是 Cursor Ж. 
Cursor 类 支持 在 查询 结果 的 数据 集合 中 以 多 种 方式 移动 ,并 能 够 获取 数据 集合 的 属性 名 
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称 和 序号 ,具体 的 方法 和 说 明 可 以 参考 表 8. 5。 


表 8.5 Cursor 类 的 公有 方法 


函 数 说 明 
moveToFirst 将 指针 移动 到 第 一 条 数据 上 
moveToNext 将 指针 移动 到 下 一 条 数据 上 
moveToPrevious 将 指针 移动 到 上 一 条 数据 上 
getCount 获取 集合 的 数据 数量 
getColumnIndexOrThrow 返回 指定 属性 名 称 的 序号 ,如果 属 性 不 存在 则 产生 异常 
getColumnName 返回 指定 序号 的 属性 名 称 
getColumnNames 返回 属性 名 称 的 字符 串 数组 
getColumnIndex 根据 性 名 称 返回 序号 
moveToPosition 将 指针 移动 到 指定 的 数据 上 
getPosition 返回 当前 指针 的 位 置 


从 Cursor 中 提取 数据 可 以 参考 Convert ToPeople O 函数 的 实现 方法 。 在 提取 
Cursor 数据 中 的 数据 前 ,推荐 测试 Cursor 中 的 数据 数量 ,避免 在 数据 获取 中 产生 异常 ， 
例如 下 面 代码 的 第 З 行 到 第 5 行 。 从 Cursor 中 提取 数据 使 用 类 型 安全 的 get< Type > O FR 
数 ,函数 的 参数 是 属性 的 序号 ,为 了 获取 属性 的 序号 ,可 以 使 用 getColumnIndex O A 4 2E 


取 指 定 属 性 的 序号 。 

Ed private People[] ConvertToPeople (Cursor cursor) ( 

2 int resultCounts- cursor.getCount () ; 

3 if (resultCounts-- 0 ||!cursor.moveToFirst ()) ( 

4 return null; 

5 } 

6 People[] peoples- new People [resultCounts]; 

T for (int i=0; i< resultCountsy i++){ 

8 peoples [i]=new People () ; 

9 peoples [i] .ID= cursor.getInt (0); 

10 peoples [i] .Name= cursor.getString (cursor.getColumnIndex (KEY _ 
NAME) ) ; 

11 peoples [i] .Age=cursor.getInt (cursor.getColumnIndex (KEY AGE) ) ; 

12 peoples [i].Height- cursor.getFloat (cursor.getColumnIndex (KEY _ 
HEIGHT)); 

13 cursor.moveToNext () 7 

14 ) 

15 return peoples; 

16 } 


要 进行 数据 查询 就 需要 调用 SQLiteDatabase 类 的 query O РЁ Ж. ix 0 Z 21 82 
多 ,可 以 参考 表 8. 6 参数 说 明 ,query() 函 数 的 语法 如 下 。 


Cursor android. database. sqlite. SQLiteDatabase. query (String table, String[] columns, 


String selection, String[] selectionArgs, String groupBy, String having, String orderBy) 
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Ж 8.6 query() 函 数 的 参数 说 明 


位 置 类 型 十 名 称 说 明 
1 String table 表 名 称 
# String[ ] columns 返回 的 属性 列 名 称 
3 String selection 查询 条 件 
4 String[] selectionArgs 如 果 在 查询 条 件 中 使 用 了 ?, 则 需要 在 这 里 定义 蔡 换 符 的 具体 
内 容 
5 String groupBy 分 组 方式 
6 String having 定义 组 的 过 滤器 
7 String orderBy 排序 方式 


下 面 分 别 给 出 根据 id 查询 数据 和 查询 全 部 数据 的 代码 。 


1 public People[] getOneData (long id) ( 


N 


Cursor results=db.query (DB_TABLE, 


new String[] { KEY_ID, KEY_NAME, KEY_AGE, KEY_ 


HEIGHT}, KEY ID+"="+id, null, null, null, null); E drg El 
3 return ConvertToPeople (results); 
4 ) i 
Es] 
1 public People[] getA11Data () ( 
2 Cursor results=db.query(DB TABLE, new String[] { KEY ID, KEY NAME, KEY AGE, KEY _ 
HEIGHT), null, null, null, null, null); 
3 return ConvertToPeople (results); 
4g 
SQLiteDemo 是 对 SQLite 数据 库 进 行 操作 的 示例 ,如 图 8. 12 所 示 。 在 这 个 示例 中 ， 
SQLiteDemo 
king 
19 
1.82 
添加 数据 全 部 显示 清除 显示 全 部 删除 
ID 删除 ID 查询 ID 更 新 
图 8.12 SQLiteDemo 用 户 界面 
用 户 可 以 在 界面 的 上 方 输入 数据 信息 ,通过 “添加 数据 ”按钮 将 数据 写 入 数据 库 。“ 全 部 
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显示 ”相当 于 查询 数据 库 中 的 所 有 数据 ,并 将 数据 显示 在 界面 下 方 。“ 清 除 显示 ” 仅 是 清 
除 界面 下 面 显 示 的 数据 ,而 不 对 数据 库 进行 任何 操作 。“ 全 部 删除 ”是 数据 库 操作 ,将 删 
除数 据 库 中 的 所 有 数据 。 在 界面 中 部 ,以 “ID 十 功能 ”命名 的 按钮 ,分 别 是 根据 ID 删除 数 
据 、 查 询 数 据 和 更 新 数据 ,而 这 个 ID 值 就 取 自 本 行 的 EditText 控件 。 这 里 不 再 给 出 
SQLiteDemo 示例 的 代码 。 
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ContentProvider( 数 据 提供 者 ) 是 应 用 程序 之 间 共 享 数据 的 一 种 接口 机 制 。 

序 运行 在 不 同 的 进程 中 ， Pad Duca 
SharedPreferences 和 文件 存储 为 跨越 程序 边界 的 访问 提供 了 方法 ,但 这 些 方法 都 存在 局 
限 性 。ContentProvider 提供 了 更 为 高 级 的 数据 共享 方法 ,应 用 程序 可 以 指定 需要 共享 的 
数据 ,而 其 他 应 用 程序 则 可 以 在 不 知道 数据 来 源 、 路 径 的 情况 下 ,对 共享 数据 进行 查询 、 
添加 、 删 除 和 更 新 等 操作 。 

Android 系统 中 ,除了 程序 开发 人 员 通 过 ContentProvider 提供 的 共享 数据 外 ,还 有 
许多 Android 系统 内 置 的 数据 也 是 通过 ContentProvider 提供 给 用 户 使 用 ,例如 通讯 录 、 
音 视频 文件 和 图 像 文 件 等 。 

在 创建 ContentProvider 前 ,首先 要 实现 底层 的 数据 源 ,数据 源 包 括 数 据 库 、 文 件 系 
统 或 网 络 等 ,然后 继承 ContentProvider 类 中 实现 基本 数据 操作 的 接口 函数 ,包括 添加 、 
删除 .查找 和 更 新 等 功能 。 调 用 者 不 能 直接 调用 ContentProvider 的 接口 函数 ,而 需要 使 
用 ContentResolver 对 象 , 通 过 URI 间接 调用 ContentProvider, 调用 关系 如 图 8. 13 
所 示 。 


І 
ContentResolver ЧЕ ContentProvide 


| хө ) ( 数据 库 ) ( 网 络 


8.13 ContentProvider 调用 关系 


在 ContentResolver 对 象 与 ContentProvider 进行 交互 时 ,通过 URI 确定 要 访问 的 
ContentProvider 数据 集 。 在 发 起 一 个 请 求 的 过 程 中 ,Android 系统 根据 URI 确定 处 理 这 
个 查询 的 ContentProvider ,然后 初始 化 ContentProvider 所 有 需要 的 资源 。 这 个 初始 化 
的 工作 是 Android 系统 完成 的 ,无须 程序 开发 人 员 参 与 。 一般 情况 下 只 有 一 个 
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ContentProvider 对 象 ,但 却 可 以 同时 与 多 个 ContentResolver 进行 交互 。 

ContentProvider 完全 屏蔽 了 数据 提供 组 件 的 数据 存储 方法 。 在 程序 开发 人 员 看 来 ， 
数据 提供 者 通过 ContentProvider 提供 了 一 组 标准 的 数据 操作 接口 ,但 却 无 须知 道 数据 
提供 者 的 内 部 数据 的 存储 方法 。 数 据 提 供 者 可 以 使 用 SQLite 数据 库存 储 数 据 , 也 可 以 
通过 文件 系统 或 SharedPreferences 存储 数据 ,甚至 是 使 用 网 络 存储 的 方法 ,这 些 数据 的 
存储 方法 和 存储 设备 对 数据 使 用 者 都 是 不 可 见 的 。 同 时 ,也 正 是 这 种 屏蔽 模式 ,很 大 程 
度 上 简化 了 ContentProvider 的 使 用 方法 ,使 用 者 只 要 调用 ContentProvider 提供 的 接口 
函数 , 即 可 完成 所 有 的 数据 操作 ,而 数据 存储 方法 则 是 ContentProvider 设计 者 需要 考虑 
的 问题 。 

ContentProvider 的 数据 集 类 似 于 数据 库 的 数据 表 , 每 行 是 一 条 记录 ,每 列 具 有 相同 
的 数据 类 型 ,如 表 8.7 所 示 。 每 条 记录 都 包含 一 个 长 型 的 字段 _ID, 用 来 唯一 标识 每 条 记 
录 。ContentProvider 可 以 提供 多 个 数据 集 , 调 用 者 使 用 URI 对 不 同 数据 集 的 数据 进行 
操作 。 


表 8.7  ContentProvider 数据 集 


_ID NAME AGE HEIGHT 
Тот 21 1.81 
2 Jim 22 1.78 


URI 是 通用 资源 标志 符 (Uniform Resource Identifier) ,用 来 定位 远程 或 本 地 的 可 用 
资源 。ContentProvider 使 用 的 URI 语法 结构 如 下 。 


1 content://<authority> /«data path» /< id> 


其 中 ,content:// 是 通用 前 级 ,表示 该 URI 用 于 ContentProvider 定位 资源 ,无 须 修改 。 
—authority > JE BE BUR 4 Fr ,用 来 确定 具体 由 哪 一 个 ContentProvider 提供 资源 。 因 此 ， 
一 般 志 authority 过 都 由 类 的 小 写 全 称 组 成 ,以 保证 唯一 性 。 过 data_path 二 是 数据 路 径 ， 
用 来 确定 请 求 的 是 哪个 数据 集 。 如 果 ContentProvider 仅 提供 一 个 数据 集 , 数 据 路 径 则 
是 可 以 省 略 的 。 但 如 果 ContentProvider 仅 提 供 多 个 数据 集 ,数据 路 径 则 必须 指明 具体 
是 哪 一 个 数据 集 。 数 据 集 的 数据 路 径 可 以 写成 多 段 格式 ,例如 people/girl 和 /people 
/boy。 一 id 二 是 数据 编号 ,用 来 唯一 确定 数据 集中 的 一 条 记录 ,用 来 匹配 数据 集中 _ID x 
段 的 值 。 如 果 请 求 的 数据 并 不 只 限于 一 条 数据 , 则 过 id 之 是 可 以 省 略 的 。 
例如 ,请 求 整个 people 数据 集 的 URI 应 写 为 : 


content://edu.hrbeu.peopleprovider/people 
而 请 求 people 数据 集中 第 3 条 数据 的 URI 则 应 写 为 : 


content://edu.hrbeu.peopleprovider/people/3 
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程序 开发 人 员 通 过 继承 ContentProvider 类 可 以 创建 一 个 新 的 数据 提供 者 ,过 程 可 
以 分 为 三 步 : 

(1) 继承 ContentProvider, 并 重 载 六 个 函数 ; 

(2) 声明 CONTENT_URI, 实 现 UriMatcher; 

(3) 注册 ContentProvider。 

下 面 按照 上 述 的 三 个 步骤 ,分 步骤 的 说 明 创 建 数据 提供 者 的 过 程 。 


1. 继承 ContentProvider ,并 重 载 6 个 函数 


新 建立 的 类 继承 ContentProvider 后 ,共有 6 个 函数 需要 重 载 ,分 别 是 delete O, 
getType() „insert ,onCreateO ,query O fll update()。 其 中 ,delete() insert() „query O 
和 update() 分 别 用 于 对 数据 集 的 删除 .添加 ,查询 和 更 新 操作 ,程序 开发 人 员 根 据 底 层 数 
据 的 存储 方式 不 同 , 使 用 不 同方 式 实现 数据 操作 。 而 onCreate() 一 般 用 来 初始 化 底层 数 
据 集 和 建立 数据 连接 等 工作 。getType() 函 数 用 来 返回 指定 URI 的 MIME 数据 类 型 ,如 
果 URI 是 单条 数据 , 则 返回 的 MIME 数据 类 型 应 以 vnd. android. cursor. item 开头 ;如果 
URI 是 多 条 数据 , 则 返回 的 MIME 数据 类 型 应 以 упа. android. cursor. dir/ 开 头 。 

新 建立 的 类 继承 ContentProvider 后 ,Eclipse 会 提示 程序 开发 人 员 需 要 重 载 部 分 的 
代码 ,并 自动 生成 需要 重 载 的 代码 框架 。 下 面 的 代码 是 Eclipse 自动 生成 的 代码 框架 。 


1 import android.content.* ; 

2 import android.database.Cursor; 

3 import android.net.Uri; 

4 

5 public class PeopleProvider extends ContentProvider( 
6 

T @Override 

8 public int delete (Uri uri, String selection, String[] selectionArgs) { 
9 //TODO Auto- generated method stub 

10 return 0; 

11 } 

12 

13 @ Override 

14 public String getType (Uri игі) { 

15 / /TODO Auto- generated method stub 

16 return null; 

XT j 

18 

19 @ Override 

20 public Uri insert (Uri uri, ContentValues values) { 
21 //TODO Auto- generated method stub 
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return null; 


@Override 
public boolean onCreate () ( 
//TODO Auto- generated method stub 


return false; 


@override 
public Cursor query (Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder)( 
///TODO Auto- generated method stub 


return null; 


@ Override 
public int update (Uri uri, ContentValues values, String selection, 
String[] selectionArgs)( 
//'TODO Auto- generated method stub 


return 0; 


2. 声明 CONTENT URI. 3239 UriMatcher 


在 新 构造 的 ContentProvider 类 中 ,经 常 需要 判断 URI 是 单条 数据 还 是 多 条 数据 ,最 
简单 的 方法 是 构造 一 个 UriMatcher。 同 时 ,为 了 便于 判断 和 使 用 URI, 一 般 将 URI 的 授 
权 者 名 称 和 数据 路 径 等 内 容声 明 为 静态 常量 ,并 声明 CONTENT_URI。 

声明 CONTENT URI 和 构造 UriMatcher 的 代码 如 下 : 


心 шю PP 


о cO - 0 m 


11 
12 


public static final String AUTHORITY- "edu.hrbeu.peopleprovider"; 
public static final String PATH SINGLE- "people/t"; 

public static final String PATH MULTIPLE- "people"; 

public static final String CONTENT URI STRING- "content ://"+ 
AUTHORITY- "/" PATH MULTIPIE; 

public static final Uri CONTENT URI-Uri.parse (CONTENT URI STRING); 
private static final int MULTIPLE PEOPLE-1; 


private static final int SINGLE PEOPLE-2; 


private static final UriMatcher uriMatcher; 
static { 
uriMatcher- new UriMatcher (UriMatcher.NO MATCH); 


uriMatcher.addURI (AUTHORITY, PATH SINGLE, MULTIPLE PEOPLE); 
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13 uriMatcher.addURI (AUTHORITY, PATH MULTIPLE, SINGLE PEOPLE); 
14 ү 


代码 第 1 行 声明 了 URI 的 授权 者 名 称 , 第 2 行 声明 了 单条 数据 的 数据 路 径 , 第 3 行 
声明 了 多 条 数据 的 数据 路 径 ,第 4 行 声明 了 CONTENT_URI 的 字符 串 形 式 , 第 5 行 则 正 
式 声 明了 CONTENT_URI, 6 行 声明 了 多 条 数据 的 返回 代码 ,第 7 行 声明 了 单条 数据 
的 返回 代码 。 第 9 行 声明 了 UriMatcher, 并 在 第 10 行 到 第 13 行 的 静态 构造 函数 中 , 声 
明了 UriMatcher 的 匹配 方式 和 返回 代码 。 其 中 ,第 11 £f UriMatcher 的 构造 函数 中 ， 
UriMatcher. NO MATCH 是 URI 无 匹配 时 的 返回 代码 。 第 12 行 的 addURIO PR 23H 
来 添加 新 的 匹配 项 ,语法 如 下 。 

1 public void addURI(String authority, String path, int code) 

其 中 ,authority 表示 匹配 的 授权 者 名 称 ,path 表示 数据 路 径 , # 可 以 代表 任何 数字 ,code 
表示 返回 代码 。 

使 用 UriMatcher 时 , 则 可 以 直接 调用 match O 函数 ,对 指定 的 URI 进行 判断 ,示例 
代码 如 下 。 

Switch (uriMatcher.match (uri))( 


сазе MULTIPLE PEOPLE: 


// 多 条 数据 的 处 理 过 程 


break; 


1 

2 

3 

4 

5 сазе SINGLE PEOPLE: 

6 // 单 条 数据 的 处 理 过 程 
7 break; 

8 default: 

9 throw new IllegalArgumentException (" 不 支持 的 URI:"+uri); 


10 } 


3. 注册 ContentProvider 


在 完成 ContentProvider 类 的 代码 实现 后 ,需要 在 AndroidManifest. xml 文件 中 进行 
注册 。 注 册 ContentProvider 使 用 二 provider 二 标签 ,示例 代码 如 下 。 


1 «application android:icon- "Q@drawable/icon" android:label- "6 string/app | 
name" 
2 «provider android:name- ".PeopleProvider" 


3 android:authorities- "edu.hrbeu.peopleprovider"/» 


4  «/application» 


在 上 面 的 代码 中 ,注册 了 一 个 授权 者 名 称 为 edu. hrbeu. peopleprovider 的 
ContentProvider, 其 实现 类 是 PeopleProvider。 


843 使 用 数据 提供 者 
使 用 ContentProvider 并 不 需要 直接 调用 类 中 的 数据 操作 函数 ,而 是 通过 Android 
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组 件 都 具有 的 ContentResolver 对 象 , 通 过 URI 进行 数据 操作 。 程 序 开 发 人 员 只 需要 知 
jË URI 和 数据 集 的 数据 格式 , 则 可 以 进行 数据 操作 ,解决 不 同 应 用 程序 之 间 的 数据 共享 
问题 。 

每 个 Android 组 件 都 具有 一 个 ContentResolver 对 象 ,获取 ContentResolver 对 象 的 
方法 是 调用 getContentResolver O KZ 


£ ContentResolver resolver=getContentResolver () ; 


1. 查询 操作 


在 获取 ContentResolver 对 象 后 ,程序 开发 人 员 则 可 以 使 用 query() 函 数 查 询 目 标 数 
据 。 下 面 的 代码 是 查询 ID 为 2 的 数据 。 


String KEY ID-" id"; 

String KEY NAME- "name"; 
String KEY AGE- "age"; 
String KEY HEIGHT- "height"; 


Uri uri-Uri.parse (CONTENT URI STRING* "/"+ "2"; 


Cursor cursor- resolver.query (uri, 


o ыч соу 0 > ш N P 


new String[] (KEY ID, KEY NAME, KEY AGE, KEY HEIGHT], null, null, null); 


从 上 面 的 代码 不 难看 出 ,在 URI 中 定义 了 需要 查询 数据 的 ID 后 ,在 query() 函 数 就 
没有 必要 再 加 入 其 他 的 查询 条 件 。 如 果 需 要 获取 数据 集中 的 全 部 数据 , 则 可 直接 使 用 
CONTENT_URI, 此 时 ContentProvider 在 分 析 URI 时 将 认为 需要 返回 全 部 数据 。 

ContentResolver 的 query OPRZi SQLite 数据 库 的 query O 图 数 非常 相似 ,语法 结 
ЫШТ. 


y Cursor query (Uri uri, String[] projection, String selection, String[] selectionArgs, 


String sortOrder) 


uri 定义 了 查询 的 数据 集 ,projection 定义 了 返回 数据 有 哪些 属性 ,selection 定义 了 
返回 数据 的 查询 条 件 。 

2. 添加 操作 

向 ContentProvider 中 添加 数据 有 两 种 方法 。 一 种 是 使 用 insert() 函数 ,向 


ContentProvider 中 添加 一 条 数据 ; 另 一 种 是 使 用 bultInsert() 函 数 , 批 量 地 添加 数据 。 下 
面 的 代码 说 明了 如 何 使 用 insert O 函数 添加 单条 数据 。 
ContentValues values- new ContentValues () ; 


values.put(KEY NAME, "Tom"); 
values.put(KEY AGE, 21); 


values.put(KEY HEIGHT, 1.81f); 


[LT 
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6 Uri newUri= геѕо1уег.іпѕегі (CONTENT URI, values); 
下 面 的 代码 说 明了 如 何 使 用 bultInsert() 函数 添加 多 条 数据 。 


X ContentValues[] arrayValues- new ContentValues [10]; 
2 //S:ffl ft — 1 ContentValues 
3 int count= resolver.bultInsert (CONTENT URI, arrayValues); 


3. 删除 操作 


删除 操作 需要 使 用 delete() 函 数 。 如 果 需 要 删除 单条 数据 , 则 可 以 在 URI 中 指定 需 
要 删除 数据 的 ID。 如 果 需 要 删除 多 条 数据 , 则 可 以 在 selection 中 声明 删除 条 件 。 下 面 
代码 说 明了 如 何 删除 ID 为 2 的 数据 。 


3, Uri uri=Uri.parse (СОМТЕМТ URI ЅТКІМС+ mn "2"); 


2 int result-resolver.delete (uri, null, null); 
也 可 以 在 selection 将 删除 条 件 定义 为 ID 大 于 4 的 数据 : 


1 String selection-KEY ID+ "> 4"; 
2 int result- resolver.delete (CONTENT URI, selection, null); 


4. 更 新 操作 


更 新 操作 需要 使 用 update() 函 数 ,参数 定义 与 delete O 函数 相同 ,同样 可 以 在 URI 
中 指定 需要 更 新 数据 的 ID, 也 可 以 在 selection 中 声明 更 新 条 件 。 下 面 代码 说 明了 如 何 
更 新 ID 为 7 的 数据 。 
ContentValues values- new ContentValues () ; 


values.put(KEY NAME, "Tom"); 
values.put(KEY AGE, 21); 


values.put(KEY HEIGHT, 1.81f); 


Uri uri-Uri.parse (CONTENT URI STRING+ "/"+"7"); 


чо 0c b QÓ N P 


int result=resolver.update (uri, values, null, пи11); 


844 示例 


ContentProviderDemo 是 一 个 无 界面 的 示例 , 仅 提 供 一 个 ContentProvider 组 件 , 供 
其 他 应 用 程序 进行 数据 交换 。 底 层 使 用 SQLite 数据 库 , 支 持 数 据 的 添加 、 删 除 、 更 新 和 
查询 等 基本 操作 。ContentResolverDemo 是 调用 ContentProvider 的 示例 ,自身 不 具有 任 
何 数 据 存 储 功 能 , 仅 是 通过 URI 访问 ContentProviderDemo 示例 提供 的 
ContentProvider. 所 以 在 运行 ContentResolverDemo 之 前 要 确保 已 经 安装 了 
ContentProviderDemo。 界 面 如 图 8. 14 所 示 : 该 界面 与 SQLiteDemo 示例 的 界面 基本 
相同 。 


数据 存储 与 访问 


229 


ContentResolverDemo 


jimmy 
8 


1.5 


添加 数据 全 部 显示 


清除 显示 全 部 删除 


ID 删除 ID 查询 ID 更 新 


图 8.14 ContentResolverDemo 用 户 界 面 


从 图 8.15 的 文件 结构 上 可 以 发 现 ,两 个 示例 都 包含 一 个 相同 的 文件 People. java, Pi 
个 示例 中 的 这 个 文件 的 内 容 也 完全 相同 ,定义 了 数据 提供 者 和 数据 调用 者 都 必须 知道 的 
信息 。 这 些 信 息 包括 授权 者 名 称 .数据 路 径 .MIME 数据 类 型 CONTENT_URI 和 数据 


项 名 称 等 。 


4 (E ContentProviderDemo 
mà Google APIs [Android 5.0.1] 
4 (9 src 
4 8 edu.hrbeu.ContentProviderDemo 
国 Peoplejava 
D) PeopleProvider java 


99 gen [Gene 


B res 

回 AndroidManifest.xml 
Ë) proguard.cfg 

В project.properties 


H Package Explorer 2 = = 


I8 Package Explorer 2 


4 @ ContentResolverDemo 
mà Google APIs [Android 5.0.1] 


4 (9 src 


D Peoplejava 


ËB gen [Generate 
B assets 

B bin 

& res 

с) AndroidManifest.xml 
Ë) proguard.cfg 


国 project.properties 


4 8 eduhrbeu.ContentResolverDemo 
国 ContentResolverDemoActivity;jav.| 


(a) ContentProviderDemo 


图 8.15 


(b) ContentResolverDemo 


示例 的 文件 结构 


下 面 分 别 给 出 People. java 文件 .PeopleProvider. java 文件 和 ContentResolver 
DemoActivity. java 文件 的 完整 代码 ,最 后 分 别 给 出 ContentProviderDemo 示例 和 
ContentResolverDemo 示例 的 AndroidManifest. xml 文件 内 容 。 

People. java 文件 的 完整 代码 如 下 。 


1 


ю 


package edu.hrbeu.ContentResolverDemo; 


import android.net.Uri; 


public class People ( 
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public static final String MIME. DIR PREFIX- "vnd.android.cursor.dir"; 
public static final String MIME ITEM PREFIX- "vnd.android.cursor.item"; 
public static final String MINE ITEM- "vnd.hrbeu.people"; 


public static final String MINE TYPE SINGLE-MIME ITEM PREFIX- W des 2 MINE ITEM; 
public static final String MINE TYPE MULTIPLE-MIME DIR PREFIX+ "Ие MINE ITEM; 


public static final String AUTHORITY- "edu.hrbeu.peopleprovider"; 

public static final String PATH SINGLE- "реор1е/#"; 

public static final String PATH MULTIPLE- "people"; 

public static final String CONTENT URI STRING- "content://"- AUTHORITY-* "/"+ PATH _ 
MULTIPLE; 

public static final Uri CONTENT URI-Uri.parse(CONTENT URI STRING); 


public static final String KEY ID-" id"; 

public static final String KEY NAME- "name"; 

public static final String KEY AGE- "age"; 

public static final String KEY HEIGHT- "height"; 
) 


PeopleProvider. java 文件 的 完整 代码 如 下 。 


package edu.hrbeu.ContentProviderDemo; 


import android.content.ContentProvider; 


import android.content.ContentUris; 

import android.content .ContentValues; 

import android.content .Context; 

import android.content.UriMatcher; 

import android.database.Cursor; 

import android.database.SQLException; 

import android.database.sqlite.SQLiteDatabase; 
import android.database.sqlite.SQLiteOpenHelper; 
import android.database.sqlite.SQLiteQueryBuilder; 
import android.database.sqlite.SQLiteDatabase.CursorFactory; 
import android.net.Uri; 


public class PeopleProvider extends ContentProvider( 
private static final String DB NAME- "people .db"; 
private static final String DB TABLE- "peopleinfo"; 


private static final int DB VERSION- 1; 


private SQLiteDatabase db; 
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private DBOpenHelper dbOpenHelper; 


private static final int MULTIPLE PEOPLE-1; 
private static final int SINGLE PEOPLE- 2; 
private static final UriMatcher uriMatcher; 


static ( 
uriMatcher- new UriMatcher (UriMatcher.NO MATCH); 


uriMatcher. addURI (People. AUTHORITY, People. PATH _ MULTIPLE, MULTIPLE — 


PEOPLE) ; 
uriMatcher.addURI (People.AUTHORITY, People.PATH SINGLE, SINGLE PEOPLE); 


@ Override 
public String getType (Uri uri) { 
switch (uriMatcher.match (uri))( 
case MULTIPLE PEOPLE: 
return People.MINE TYPE MULTIPLE; 
case SINGLE PEOPLE: 
return People.MINE TYPE SINGLE; 
default: 
throw new IllegalArgumentException ("Unkown игі:"+ uri); 


@ Override 
public int delete (Uri uri, String selection, String[] selectionArgs)( 
int count-0; 
Switch (uriMatcher.match (uri))( 
case MULTIPLE PEOPLE: 
count-db.delete(DB TABLE, selection, selectionArgs); 
break; 
case SINGLE PEOPLE: 
String segment- uri.getPathSegments () .get (1) ; 


count- db. delete (DB _ TABLE, People. KEY ID +" =" + segment, 


selectionArgs); 
break; 
default: 
throw new IllegalArgumentException ("Unsupported URI:"- uri); 
} 
getContext () .getContentResolver () .notifyChange (uri, null); 


return count; 
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@ Override 
public Uri insert (Uri uri, ContentValues values)( 
long id-db.insert(DB TABLE, null, values); 
if(id »0)( 
Uri newUri- ContentUris.withAppendedId (People.CONTENT URI, id); 
getContext () .getContentResolver () .notifyChange (newUri, null); 
return newUri; 
) 


throw new SQLException ("Failed to insert row into "*uri); 


@ Override 

public boolean onCreate () { 
Context context- getContext () ; 
dbOpenHelper-new DBOpenHelper (context, DB NAME, null, DB VERSION); 
db- dbOpenHelper.getWritableDatabase (); 


if (do--null) 
return false; 
else 


return true; 


@ Override 
public Cursor query (Uri uri, String[] projection, String selection, 
String[] selectionArgs, String sortOrder)( 
SQLiteQueryBuilder qb- new SQLiteQueryBuilder(); 
qb.setTables(DB TABLE); 
Switch (uriMatcher.match (uri))( 
case SINGLE PEOPLE: 
qo.appendWhere (People.KEY ID+ "= "+uUri.getPathSegments () 
-get (1)); 
break; 
default: 
break; 
) 
Cursor cursor- qb.query (db, 
projection, 
selection, 
SselectionArgs, 
null, 
null, 
sortOrder); 
cursor.setNotificationUri (getContext () .getContentResolver (), uri); 


108 
109 
110 
111 
112 
113 
114 
115 
116 
i 
118 
119 
120 
121 


122 
123 
124 
125 
126 
127 
128 
129 
130 
131 
132 
133 


134 
135 
136 
137 
138 
139 


140 
141 
142 
143 
144 
145 
146 
147 


z@= 数据 存储 与 访问 


233 


return cursor; 


@Override 


public int update (Uri uri, ContentValues values, String selection, 


String[] selectionArgs)( 
int count; 
switch (uriMatcher.match (uri) ) { 
case MULTIPLE PEOPLE: 


count=cb.update (DB TABIE, values, selection, selectionArgs); 


break; 
case SINGLE PEOPLE: 


String segment- uri.getPathSegments () .get (1) ; 


count- db. update (DB TABLE, values, People.KEY Ір+"="+ segment, 


selectionArgs); 
break; 
default: 


throw new IllegalArgumentException ("Unknow URI:"- uri); 


) 


getContext () .getContentResolver ().notifyChange (uri, null); 


return count; 


private static class DBOpenHelper extends SQLiteOpenHelper ( 


public DBOpenHelper (Context context, String name, CursorFactory factory, 


int version)( 


super (context, name, factory, version); 


private static final String DB CREATE- "create table "+ 


DB ТАВІЕ+ "("+РеорІе.КЕҮ ID+" integer primary key autoincrement, "+ 
People.KEY МАМЕ+ " text not null, "+ People.KEY AGE+" integer,"* People. 


KEY HEIGHT+ " float);"; 


@ Override 
public void onCreate (SQLiteDatabase db)( 
. db.execSQL(DB CREATE); 


@ Override 
public void onUpgrade (SQLiteDatabase _ db, 


newVersion) { 


int 


_ oldVersion, 


int 
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. db.execSQL ("DROP TABLE IF EXISTS "+DB TABLE); 
onCreate ( db); 


) 


ContentResolverDemoActivity. java 文件 的 完整 代码 如 下 。 
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package edu.hrbeu.ContentResolverDemo; 


import android.app.Activity; 

import android.content .ContentResolver; 
import android.content .ContentValues; 
import android.database.Cursor; 

import android.net.Uri; 

import android.os.Bundle; 

import android.view.View; 

import android.view.View.OnClickListener; 
import android.widget.Button; 

import android.widget.EditText; 

import android.widget.TextView; 


public class ContentResolverDemoActivity extends Activity { 


private EditText nameText; 
private EditText ageText; 
private EditText heightText; 
private EditText idEntry; 


private TextView labelView; 
private TextView displayView; 


private ContentResolver resolver; 


@Override 

public void onCreate (Bundle savedInstanceState) { 
super.onCreate (savedInstanceState); 
setContentView (R. layout main); 


nameText- (EditText) findViewById (R.id.name); 
ageText- (EditText) findViewByld (R.id.age); 
heightText- (EditText) findViewById (R.id.height); 
idEntry- (EditText)findViewById (R.id.id entry); 
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labelView- (TextView)findViewByIld (R.id.label); 
displayView- (TextView)findViewById (R.id.display); 


Button addButton- (Button) findViewById (R.id.add); 

Button queryAllButton- (Button) findViewById (R.id.query all); 
Button clearButton- (Button) findViewById (R.id.clear); 

Button deleteAllButton- (Button) findViewById (R.id.delete all); 


Button queryButton- (Button) findViewById (R.id.query); 
Button deleteButton- (Button) findViewById (R.id.delete); 
Button updateButton- (Button) findViewById (R.id.update); 


addButton.setOnClickListener (addButtonListener); 
queryAllButton.setOnClickListener (queryAllButtonListener); 
clearButton.setOnClickListener (clearButtonListener); 
deleteAllButton.setOnClickListener (deleteAllButtonListener); 


queryButton.setOnClickListener (queryButtonListener); 
deleteButton.setOnClickListener (deleteButtonListener); 


updateButton.setOnClickListener (updateButtonListener); 


resolver- this.getContentResolver (); 


OnClickListener addButtonListener- new OnClickListener () ( 


@ Override 
public void onClick (View v) ( 


ContentValues values- new ContentValues|(); 


values.put(People.KEY NAME, nameText.getText () .toString()); 
values.put(People.KEY AGE, Integer.parseInt (ageText .get Text () 
-toString ())); 

values.put(People.KEY HEIGHT, Float.parseFloat (heightText 
-getText () .toString())); 


Uri newUri- resolver.insert (People.CONTENT URI, values); 


labelView.setText ("添加 成 功 ,URI:"+newUri); 
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OnClickListener queryAllButtonListener- new OnClickListener () ( 
@ Override 
public void onClick (View у) { 
Cursor cursor- resolver.query (People.CONTENT URI, 
new String[] ( People.KEY ID, People.KEY NAME, People 
-KEY AGE, People.KEY HEIGHT], 
null, null, null); 
if(cursor--null)( 
labelView.setText ("数据 库 中 没有 数据 "); 
return; 
} 
labelView.setText ("数据 库 :"+ String.valueOf (cursor.getCount ()) + "条 记 
ж"); 


String msg-""; 
if (cursor.moveToFirst ()) { 
do( 

msgt-"ID:"-4 cursor.getInt (cursor.getColumnIndex (People. KEY . 
Pony Ea 
msg+= "姓名 :"+ cursor. getString (cursor.getColumnIndex (People. 
KEY NAME))-*","; 
msg+= 年 龄 :"+ cursor.getInt (cursor.getColumnIndex (People.KEY_ 
АСЕ))+","; 
msg+= 身 高 :"+ cursor. getFloat (cursor. getColumnIndex (People. 
KEY HEIGHT))- "An"; 


)while (cursor.moveToNext () ) 7 


displayView.setText (msg) ; 


OnClickListener clearButtonListener- new OnClickListener () ( 


@Оуеггіае 
public void onClick (View у) { 
displayView.setText (""); 


OnClickListener deleteAllButtonListener- new OnClickListener () { 
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@Override 

public void onClick (View у) { 
resolver.delete (People.CONTENT_URI, null, null); 
String msg- "数据 全 部 删除 "> 


labelView.setText (msg); 


н 


OnClickListener queryButtonListener- new OnClickListener () ( 
@override 
public void onClick (View v) { 
Uri uri-Uri.parse(People.CONTENT URI STRING+ "/"+ idEntry 
-getText () .上 toString ()); 


Cursor cursor=resolver.query(uri, 


new String[] ( People.KEY ID, People.KEY NAME, People 


.KEY AGE, People.KEY HEIGHT], 
null, null, null); 
if (cursor--null)( 
labelView.setText ("数据 库 中 没有 数据 "); 


return; 


String msg=""; 

if (cursor.moveToFirst () ) ( 
msg+ 
ID))+ 


" ID:" + cursor. getInt (cursor. getColumnIndex (People. KEY _ 


msg+= "姓名 :"+ cursor. getString (cursor.getColumnIndex (People.KEY _ 


NAME) )+ ","; 


msg = "年 龄 :"+ cursor -getInt (cursor.getColumnIndex (People 


.KEY АСЕ))+", "; 
msg+=" 身 高 
HEIGHT))- "An"; 


labelView.setText (" 数 据 库 :") ; 
displayView.setText (msg) ; 


OnClickListener deleteButtonListener- new OnClickListener () ( 
@override 


public void onClick (View у) { 


Uri uri-Uri.parse(People.CONTENT URI STRING* "/"+ idEntry 


cursor.getFloat (cursor.getColumnIndex (People. KEY _ 
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-getText () .toString()); 

int result- resolver.delete (uri, null, null); 

String msg- "删除 ID 为 "+ idEntry.getText () .toString ()+" 的 数据 "+ (result 
>02 "成 功 ":" 失 败 ")7 

labelView.setText (msg); 


OnClickListener updateButtonListener- new OnClickListener () { 
@override 
public void onClick (View v) { 


ContentValues values- new ContentValues(); 


values.put(People.KEY NAME, nameText.getText ().toString()); 
values.put(People.KEY AGE, Integer.parseInt (ageText.getText () 
-toString())); 

values.put(People.KEY HEIGHT, Float.parseFloat (heightText 
-getText () .toString())); 


Uri uri-Uri.parse(People.CONTENT URI STRING+ "/"+ idEntry 
.getText () .上 toString () ) 7 


int result=resolver.update (uri, values, null, null); 


String msg= "更 新 ID 为 叶 idEntry.getText ().toString ()+" 的 数据 "+ (result 
>02" 成 功 ":" 失 败 "); 
labelView.setText (msg) ; 


J; 
} 


ContentProviderDemo 示例 的 AndroidManifest. xml 文件 内 容 。 
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11 


<?xml version- "1.0" encoding- "utf- 8"? > 

«manifest xmlns:android- "http://schemas .апігоіа.соп/арк/геѕ/апагоіа" 
package- "edu.hrbeu.ContentProviderDemo" 
android:versionCode- "1" 


android:versionName- "1.0"> 


«application android:icon- "ё drawable/icon" android:label- "8? string/app name" 
INE: 
A 


«provider android:name- ".PeopleProvider" 
android:authorities- "edu.hrbeu.peopleprovider"/» 
< /application» 


«uses- sdk android:minSdkVersion- /> 


< /manifest> 
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ContentResolverDemo 示例 的 AndroidManifest. xml 文件 内 容 。 


1 <?xml version= "1.0" encoding- "utf- 8"? > 

2 «manifest xmlns:android= "http://schemas.android.com/apk/res/android" 

3 package= "edu.hrbeu.ContentResolverDemo" 

4 android:versionCode= "1" 

5 android:versionName="1.0"> 

6 «application android:icon- "8 drawable/icon" android:label- "6 string/app name"> 
Y «activity android:name- ".ContentResolverDemo" 

8 android:label- "8 string/app name"? 

9 < intent- filter» 

10 <action android:name= "android.intent.action.MAIN" /> 

11 < category android:name- "android.intent.category.LAUNCHER" /> 
12 < /intent- filter» 

13 < /activity» 

14 « /application» 

15 «uses- sdk android:minSdkVersion- "3" /> 


16 «/manifest» 
= Ей 


1. 应 用 程序 一 般 允 许 用 户 自 己 定义 配置 信息 ,如 界面 背景 颜色 .字体 大 小 和 字体 颜 
色 等 ,尝试 使 用 SharedPreferences 保存 用 户 的 自 定 义 配 置信 息 , 并 在 程序 启动 时 自动 加 
载 这 些 自 定义 的 配置 信息 。 

2. 尝试 把 第 1 题 的 用 户 自 己 定义 配置 信息 ,以 INI 文 件 的 形式 保存 在 内 部 存储 
器 上 。 

3. 简 述 在 散 入 式 系统 中 使 用 SQLite 数据 库 的 优势 。 

4. 分 别 使 用 手动 建 库 和 代码 建 库 的 方式 ,创建 名 为 test. db 的 数据 库 , 并 建立 staff 
数据 表 , 表 内 的 属性 值 如 表 8. 8 所 示 。 


表 8.8 staff 表 属 性 值 


属 性 数据 类 型 说 明 
іа integer 主键 
name text 姓名 
sex text 性 别 
department text 所 在 部 门 
salary float 工资 


5. 利用 第 4 题 所 建立 的 数据 库 和 staff # ,为 程序 提供 添加 、 删 除 和 更 新 等 功能 ,并 
尝试 将 表 8. 9 中 的 数据 添加 到 staff 表 中 。 


表 8.9  peopleinfo 表 内 容 
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пате ѕех department salary 
1 Tom male computer 5400 
2 Einstein male computer 4800 
3 Lily female 1.68 5000 
4 Warner male 
5 Napoleon male 


6. 建立 一 个 ContentProvider, 用 来 共享 第 4 题 所 建立 的 数据 库 。 


位 置 服务 与 地 图 应 用 


位 置 服务 和 地 图 应 用 是 发 展 最 为 迅速 ,具有 潜在 需求 的 领域 。 通 过 本 章 的 学 习 可 以 
让 读者 了 解 位 置 服务 和 地 图 应 用 的 概念 方法 和 技巧 ,并 使 用 Google 提供 的 地 图 服务 构 
建 具有 位 置 服务 功能 的 应 用 程序 。 

本 章 学 习 目 标 : 

° 了 解 位 置 服务 的 概念 ; 

° 了 解 地 图 密 钥 的 申请 方法 ; 

° 掌握 获取 位 置信 息 的 方法 ; 

* 掌握 MapView 和 MapController 的 使 用 方法 ; 

* 掌握 Google 地 图 覆盖 层 的 使 用 方法 。 
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位 置 服 务 (Location-Based Services. LBS) ,又 称 定 位 服务 或 基于 位 置 的 服务 ,融合 了 
GPS 定位 、 移 动 通信 、 导 航 等 多 种 技术 ,提供 与 空间 位 置 相 关 的 综合 应 用 服务 。 位 置 服务 
首先 在 日 本 得 到 商业 化 的 应 用 。2001 年 7 H .DoCoMo 发布 了 第 一 款 具 有 三 角 定 位 功能 
的 手持 设备 ,2001 年 12 月 ,KDDI 发 布 第 一 款 具 有 GPS 功能 的 手机 。 近 些 年 来 ,基于 位 
置 的 服务 发 展 更 加 迅速 ,涉及 商务 .医疗 .工作 和 生活 的 各 个 方面 ,为 用 户 提供 定位 .追踪 
和 敏感 区 域 警告 等 一 系列 服务 。 

Android 平台 支持 提供 位 置 服 务 的 API, 在 开发 过 程 中 主要 使 用 LocationManager 
和 LocationProviders 对 象 。 

LocationManager 可 以 用 来 获取 当前 的 位 置 ,追踪 设备 的 移动 路 线 ,或 设 定 敏感 区 
域 ,在 进入 或 离开 敏感 区 域 时 设备 会 发 出 特定 警报 。LocationProviders 则 是 提供 定位 功 
能 的 组 件 集合 ,集合 中 的 每 种 组 件 以 不 同 的 技术 提供 设备 的 当前 位 置 ,区 别 在 于 定位 的 
精度 .速度 和 成 本 等 方面 。 

为 了 使 开发 的 程序 能 够 提供 位 置 服务 ,首先 的 问题 是 如 何 获 取 LocationManager。 
获取 LocationManager 可 以 通过 调用 android. app. Activity. getSystemService O 函数 获 
取 , 代 码 如 下 。 
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1 String serviceString-Context.LOCATION SERVICE; 
2 LocationManager LocationManager- (LocationManager) 


getSystemService (serviceString); 


代码 第 2 行 的 getSystemService() 函 数 , 可 以 根据 服务 名 称 获取 Android 提供 的 系 
统 级 服务 。 代 码 第 1 行 的 Context. LOCATION_SERVICE 指明 获取 的 是 位 置 服务 。 
Android 支持 的 系统 级 服务 如 表 9. 1 所 示 。 


表 9.1 Android 支持 的 系统 级 服务 
Context 类 的 静态 常量 值 返回 对 象 说 明 
LOCATION_SERVICE location LocationManager eie изаа 
WINDOW_SERVICE window WindowManager 最 顶层 的 窗口 管理 器 


LAYOUT INFLATER SERVICE 


layout inflater 


LayoutInflater 


将 XML 资源 实例 化 
为 View 


POWER SERVICE power PowerManager 电源 管理 
ALARM_SERVICE alarm AlarmManager res 时 间接 受 
NOTIFICATION_SERVICE notification NotificationManager | 后 台 事件 通知 
KEYGUARD_ SERVICE keyguard KeyguardManager 锁定 或 解锁 键盘 
SEARCH_SERVICE search SearchManager 访问 系统 的 搜索 服务 
VIBRATOR_SERVICE vibrator Vibrator 访问 支持 振动 的 硬件 
CONNECTIVITY SERVICE connection ConnectivityManager | 网 络 连接 管理 

WIFI SERVICE wifi WifiManager WiFi 连接 管理 
INPUT_METHOD_SERVICE input_method | InputMethodManager | 输入 法 管理 


在 获取 LocationManager 后 ,还 需要 指定 LocationManager 的 定位 方法 ,然后 才能 够 
调用 LocationManager. getLastKnowLocation( ) 方 法 获取 当前 位 置 。 目 前 LocationManager 
中 主要 有 两 种 定位 方法 ,分别 是 使 用 GPS 定位 和 使 用 网 络 定位 。GPS 定位 可 以 提供 精 
确 的 位 置信 息 , 但 定位 速度 和 质量 受到 卫星 数量 和 环境 情况 的 影响 。 网 络 定位 提供 的 
位 置信 息 精 度 较 差 ,但 速度 较 GPS 定位 要 迅速 。LocationManager 支持 定位 方法 参考 
表 9. 2。 


表 9.2 LocationManager 支持 定位 方法 


Location Manager 


类 的 静态 常量 ы ти 


使 用 GPS 定位 .利用 卫星 提供 精确 的 位 置信 息 ,需要 


GPS PROVIDER св" android. permissions. ACCESS_FINE_LOCATION 用 户 权限 
使 用 网 络 定位 .利用 基站 或 WiFi 访问 的 提供 近似 的 位 置信 
息 , 需 1 , 

NETWORK. PROVIDER | network | Ë ЕНШ FER: 


android. permission. ACCESS _ COARSE _ LOCATION 或 
android. permission. ACCESS FINE LOCATION 
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在 指定 LocationManager 的 定位 方法 后 , 则 可 以 调用 getLastKnowLocation() 方 法 
获取 当前 的 位 置信 息 。 以 使 用 GPS 定位 为 例 ,获取 位 置信 息 的 代码 如 下 。 


1 String provider- LocationManager.GPS PROVIDER; 
> Location location- locationManager.getLastKnownLocation (provider); 


代码 第 2 行 返回 的 Location 对 象 中 .包含 了 可 以 确定 位 置 的 信息 ,如 经 度 、 纬 度 和 速 
度 等 ,用 户 可 通过 调用 Location 中 的 getLatitude() 和 getLonggitude() 方 法 分 别 获 取 位 
置信 息 中 的 纬度 和 经 度 , 示 例 代码 如 下 。 


1 double lat-location.getLatitude (); 
2 double lng= location.getLongitude (); 


在 很 多 提供 定位 服务 的 应 用 程序 中 ,不 仅 需要 获取 当前 的 位 置信 息 , 还 需要 监视 位 
置 的 变化 ,在 位 置 改变 时 调用 特定 的 处 理 方法 。LocationManager 提供 了 一 种 便捷 高效 
的 位 置 监视 方法 requestLocationUpdates O ,可 以 根据 位 置 的 距离 变化 和 时 间 间 隔 设 定 ， 
产生 位 置 改变 事件 的 条 件 , 这 样 可 以 避免 因 微小 的 距离 变化 而 产生 大 量 的 位 置 改变 事 
件 。LocationManager 中 设 定 监听 位 置 变化 的 代码 如 下 。 


locationManager.requestLocationUpdates (provider, 2000, 10, locationListener); 


第 1 个 参数 是 定位 的 方法 ,GPS 定位 或 网 络 定位 ;第 2 个 参数 是 产生 位 置 改变 事件 

的 时 间 间 隔 , 单 位 为 微 秒 ;第 3 个 参数 是 距离 条 件 , 单 位 是 米 ; 第 4 个 参数 是 回调 函数 ,用 

了 处 理 位 置 改变 事件 。 上 面 的 代码 将 产生 位 置 改变 事件 的 条 件 设 定 为 距离 改变 10 Ж. 
时 间 间 隔 为 2 秒 。 实 现 locationListener 的 代码 如 下 。 

LocationListener locationListener=new LocationListener (){ 


public void onLocationChanged (Location location) { 
} 


1 

2 

3 

4 public void onProviderDisabled (String provider) { 

5 } 

6 public void onProviderEnabled (String provider) { 

y } 

8 public void onStatusChanged (String provider, int status, Bundle extras)( 
9 } 

10 }; 


代码 第 2 行 的 onLocationChanged() 在 位 置 改变 时 被 调用 ,第 4 行 的 onProviderDisabled() 
在 用 户 禁用 具有 定位 功能 的 硬件 时 被 调用 ,第 6 行 的 onProviderEnabled() 在 用 户 启 
用 具有 定位 功能 的 硬件 时 被 调用 ,第 8 行 的 onStatusChanged() 在 提供 定位 功能 的 硬 
件 状 态 改变 时 被 调用 ,如 从 不 可 获取 位 置信 息 状 态 到 可 以 获取 位 置信 息 的 状态 , 反 
之 亦 然 。 

最 后 ,为 了 使 GPS 定位 功能 生效 .还 需要 在 AndroidManifest. xml 文件 中 加 入 用 户 
许可 ,代码 如 下 。 
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«uses- permission android:name- "android.permission.ACCESS FINE IOCATION"/> 


CurrentLocationDemo 是 一 个 提供 基本 位 置 服务 的 示例 ,可 以 显示 当前 位 置信 息 , 并 
能 够 监视 设备 的 位 置 变 化 。CurrentLocationDemo 的 用 户 界 面 如 图 9. 1 所 示 。 

位 置 服务 一 般 都 需要 使 用 设备 上 的 硬件 ,最 理想 的 调试 方式 是 将 程序 上 传 到 物理 设 
备 上 运行 ,但 在 没有 物理 设备 的 情况 下 ,也 可 以 使 用 Android 模拟 器 提供 的 虚拟 方式 模 
拟 设备 的 位 置 变化 ,调试 具有 位 置 服务 的 应 用 程序 。 首 先 打开 DDMS 中 的 模拟 器 控制 ， 
TE Location Controls 中 的 Longitude 和 Latitude 部 分 输入 设备 当前 的 经 度 和 纬度 ,然后 
点 击 Send 按钮 ,就 将 虚拟 的 位 置信 息 发 送 到 Android 模拟 器 中 ,如 图 9. 2 所 示 。 


© Emulator Control 2 = 


Location Controls 


Manual [epx [ kc. 


@ Decimal 


CurrentLocationDemo 


Sexagesimal 


Longitude -122.084095 


m 


Latitude 37.422006 


9.1 CurrentLocationDemo 示例 界面 9.2 模拟 位 置信 息 


在 程序 运行 过 程 中 ,可 以 在 模拟 器 控制 器 中 改变 经 度 和 纬度 坐标 值 , 程 序 在 检测 到 
位 置 的 变化 后 ,会 将 最 新 的 位 置信 息 显示 在 界面 上 。 
下 面 给 出 CurrentLocationDemo 示例 中 LocationBasedServiceDemoActivity. java Ж 


件 的 完整 代码 。 


1 package edu.hrbeu.LocationBasedServiceDemo; 


3 import android.app.Activity; 

import android.content.Context; 

import android.os.Bundle; 

import android.widget.TextView; 

import android.location.Location; 

import android.location.LocationListener; 


import android.location.LocationManager; 


11 public class LocationBasedServiceDemoActivity extends Activity { 


12 @ Override 

13 public void onCreate (Bundle savedInstancesState) { 
14 super.onCreate (savedInstanceState); 

15 setContentView (R.layout.main); 

16 


T? String serviceString-Context.LOCATION SERVICE; 


18 
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LocationManager locationManager= (LocationManager)getSystemService 


(serviceString); 


String provider- LocationManager.GPS PROVIDER; 

Location location- locationManager.getLastKnownLocation (provider); 
getLocationInfo (location); 

locationManager.requestLocationUpdates (provider, 2000, 0, 


locationListener); 


private void getLocationInfo (Location location) { 


String latLongInfo; 
TextView locationText- (TextView) findViewById (R.id.txtshow); 
if(location!-null)( 
double lat- location.getLatitude (); 
double lng= location.getLongitude (); 
latLongInfo- "Lat: "+ lat- "AnLong: "+ lng7 
) 
else( 
latLongInfo- "No location found"; 
) 
locationText.setText ("Your Current Position 15:\п"+ latLongInfo); 


private final LocationListener locationListener- new LocationListener () { 


@ Override 

public void onLocationChanged (Location location) { 
getLocationInfo (location); 

b 

@ Override 

public void onProviderDisabled (String provider)( 
getLocationInfo (null); 

) 

@ Override 

public void onProviderEnabled (String provider) { 
getLocationInfo (null); 

1 

@ Override 

public void onStatusChanged (String provider, int status, Bundle extras) { 
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921 申请 地 图 密 钥 


为 了 在 手机 中 更 直观 地 显示 地 理 信息 ,程序 开发 人 员 可 以 直接 使 用 Google 提供 的 
地 图 服务 ,实现 地 理 信息 的 可 视 化 开发 。 只 要 使 用 MapView (com. google. android. 
maps. MapView) 就 可 以 将 Google Hb В Л Android 应 用 程序 中 。 但 在 使 用 MapView 
进行 开发 前 ,必须 向 Google 申请 经 过 验证 的 “地 图 密 钥 ”(Map API Key) ,这 样 才 能 正常 
使 用 Google 的 地 图 服务 。“ 地 图 密 钥 ”是 访问 Google 地 图 数据 的 密 钥 ,无 论 是 模拟 器 还 
是 在 真实 设备 都 需要 使 用 这 个 密 钥 。 

注册 “地 图 密 钥 ”的 第 一 步 是 申请 一 个 Google 账户 ,也 就 是 Gmail 电子 邮箱 ,申请 地 
址 是 https://www. google. com/accounts/Login。 

在 得 到 Google 账户 之 后 ,下 一 步 工 作 是 找到 保存 Debug 证 书 的 keystore 的 位 置 , 并 
获取 证 书 的 SHA1 值 。keystore 是 一 个 密码 保护 的 文件 ,用 来 存储 Android 的 证 书 , 获 
取 MD5 散 列 值 的 主要 目的 是 为 下 一 步 申 请 “地 图 密 钥 ”做 准备 。 获 取 Debug 证 书 的 保存 
位 置 的 方法 如 图 9. 3 所 示 ,首先 打开 Eclipse, 通 过 Window Preferences 打开 配置 窗 体 ， 
TE Android Build 栏 中 的 Default debug keystore 中 可 以 找到 。 


© Preferences _ [не 
[pe fierten || Build SECUS 
, €: ^, | Build Settings: 
Ы A | Automatically refresh Resources and Assets folder on build 
p (i Force error when external jars contain native libraries 
tni | Skip packaging and dexing until export or launch. (Speeds up automatic builds on file save) 
Launch | Build output. 
UnttrorChedów | | @ Silent 
> LogCat © Normal 
NDK © Verbose 
Usage Stats 2 | 
Ре | Default debug keystore: CAUsers\ce\ android\debug keystore 
» C/C++ MDS fingerprint: 3C:D4:6A:D1:S4:DD:E1:A1:CS:18:00:62:A1:9D:BA:12 
b Code Recommenders ' 
Кык | SHA1 fingerprint: 9F.A1:26:FE:D7:A2:D4:99:25:32:D1:S8:B7:0D:97:C4:AC:B0:D7:C6 
b Install/Update | Custom debug keystore: Browse... 
b Java | š - — 
b Maven MOUNTS 
» мууп | SHA1 fingerprint: 
b Run/Debug 
b Team 
T —— тра 


@ o ][ ска 


图 9.3 命令 运行 结果 


为 了 获取 Debug 证 书 MD5 散 列 值 的 ,需要 打开 命令 行 工 具 CMD, 然 后 切换 到 
命 


keystore 的 目录 , 即 C; NUsers VH P! 4. android. 输 入 如 下 命令 。 


四 
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keytool - list -v - keystore debug.keystore 
Keytool 是 JDK 提供 的 工具 ,如 果 提 示 无 法 找到 keytool, 可 以 将 二 Java SDK /bin 
的 路 径 添加 到 系统 的 PATH 变量 中 。 在 提示 输入 keystore 密码 时 ,输入 密码 android. 
或 直接 输入 回 车 ,MD5 .SHA1 和 SHA256 散 列 值 将 都 显示 出 来 。 如 图 9. 4 Bros ,笔者 的 
SHA1 散 列 值 为 9F:Al1:26:FE:D7:A2:D4:99:25:32:D1:58:B7:0D:97:C4:AC:B0: 
D7:C6 。 


[ Bš cAWinaowsusystemszma=s= Nil ч eas) 


9.4 获取 keystore 的 MD5 散 列 值 


申请 “地 图 密 钥 ”的 最 后 一 步 是 打开 申请 页 面 ,输入 SHA1 散 列 值 以 及 应 用 程序 的 包 
名 并 以 分 号 隔 开 ,比如 本 次 使 用 示例 程序 包 名 为 edu. hrbeu. GoogleMapDemo, 输 入 内 容 
如 下 :; 9F:Al:26:FE:D7:A2:D4:99:25:32:D1:58:B7:0D:97:C4:AC:B0:D7:C6i;edu， 
hrbeu. GoogleMapDemo。 申 请 页 面 的 地 址 是 https://console. developers. google. com/， 
选择 在 api 列表 中 选择 Google Map, 之 后 转 到 如 图 9.5 所 示 界 面 。 


Google apis 


апу. 


API Access 
оном Te ренеп abuse, Googie places Lesen on API рез Using a vald OAuth token or AFI key allows you to exceed anonymous iis by connecting requests back to yaur praject 
Services 
Бев Authorized API Access. 

АР Acces 
Hoports - 
Quotas 


Create an OAuth 2.0 client ID... 


Simpie API Access. 
ma 


图 9.5 获取 Map API Key 页 面 


输入 后 ,点 击 Create 按钮 ,将 生成 申请 “地 图 密 钥 ”的 获取 结果 ,如 图 9.6 所 示 。 
笔者 获取 的 “地 图 密 钥 ”是 AIzaSyD38FLaaFTXKETXoftWGC9cS0cnPeGUhrY ,在 
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Key for Android а 
API key 

Android apps: 
Activated on: 
Aclvaredby. — uctervilagegomal com - you 


图 9.6 “地 图 密 钥 ” 获 取 结 果 


以 后 使 用 到 MapView 的 时 候 都 需要 输入 这 个 密 钥 。 但 需要 注意 的 是 ,读者 必须 根据 
Debug 证 书 的 SHA1 值 ,自己 到 Google 网 站 上 申请 一 个 用 于 调试 程序 的 “地 图 密 钥 ”, 而 
不 能 使 用 上 面 笔者 申请 到 的 “地 图 密 钥 ” ,并且 密 钥 与 应 用 程序 包 名 要 一 一 对 应 。 


922 使 用 Google 地 图 


在 申请 到 “地 图 密 钥 "后, 下面 应 考虑 如 何在 Android 系统 中 显示 和 控制 Google 地 
图 。MapView 是 地 图 的 显示 控件 ,可 以 设置 不 同 的 显示 模式 ,例如 卫星 模式 、 街 道 模式 
或 交通 模式 。 而 MapController 则 是 MapView 的 控制 器 ,可 以 控制 MapView 的 显示 中 
心 和 缩放 级 别 等 功能 。 

下 面 的 内 容 以 GoogleMapDemo 为 例 ,说 明 如 何在 Android 系统 中 开发 Google 地 图 
程序 。 这 个 示例 将 在 程序 内 部 设置 一 个 坐标 点 ,然后 在 程序 启动 时 ,使 用 MapView 控件 
在 地 图 上 显示 这 个 坐标 点 的 位 置 。 

因为 普通 版 本 的 Android SDK 并 不 包含 Google 地 图 的 开发 扩展 库 , 因 此 在 建立 工 
程 时 需 将 com. google. android. maps 扩展 库 添加 到 工程 中 ,这 样 就 可 以 使 用 Google 地 图 
的 所 有 功能 。 添 加 com. google. android. maps 扩展 库 的 方式 是 在 创建 工程 时 ,在 Build 
Target 项 中 选择 Google APIs, 如 图 9.7 所 示 。 


New Android Applicati 


New Android Application | 
Creates а new Android Application. 


Application Мате:0 GoogleMapDemo 
Project Name:9 GoogleMapDemo 
Package Name:9 edu hrbeu.GoogleMapDemo 


Minimum Required SDK:0 [Apl 8: Android 2.2 (Froyo) z) 

Target SDK:O|API 21: Android 4Х (L Preview) +| 

coro vo idt r 
Theme: А81 Em 


Q Choose a target API to compile your code against, from your installed SDKs. This is typically the 
most recent version, or the first version that supports all the APIs you want to directly access 
without reflection. 


Qo < Back Са] Einish | [Semata 


9.7 引入 Google 地 图 扩展 库 
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创建 工程 后 ,修改 /res/layout/activity_main. xml 文件 ,布局 文中 加 入 一 个 MapView 
控件 ,并 设置 刚 获 取 的 “地 图 密 钥 ”。activity_main. xml 文件 的 完整 代码 如 下 。 


x <?xml version- "1.0" encoding- "utf- 8"?> 
2  «LinearLayout xmlns:android- "http: //schemas .android.com/apk/res/android" 


3 android:orientation= "vertical" 

4 android:layout width- "fill parent" 

5 android:layout height- "fill parent"? 

6 < TextView android:layout width= "fill parent" 
T android:layout height- "wrap content" 

8 android:text- "@ string/hello"/» 

9 

10 < com.google.android.maps.MapView 

11 апагоіа:ід= "@ + іа/таруіем" 

12 android:layout_width="fill_parent" 

13 android:layout_height="fill parent" 

14 android:enabled= "true" 

15 android:clickable= "true" 

16 android:apiKey= "AIzaSyD38FLaaFTXKETXoftWGC9cS0cnPeGUhrY"/> 


17 «/LinearLayout» 


仅 在 布局 中 添加 MapView 控件 ,还 不 能 够 直接 在 程序 中 调用 这 个 控件 ,还 需要 将 程 
序 本 身 设 置 成 MapActivity (com. google. android. maps. MapActivity), MapActivity 类 
负责 处 理 显示 Google 地 图 所 需 的 生命 周期 和 后 台 服 务 管 理 。 

下 面 给 出 整个 GoogleMapDemoActivity. java 文件 的 完整 代码 。 


package edu.hrbeu.GoogleMapDemo; 


import com.google.android.maps.GeoPoint; 


E 
2 
3 
4 import com.google.android.maps.MapActivity; 

5 import com.google.android.maps.MapController; 
6 import com.google.android.maps.MapView; 

1 

8 import android.os.Bundle; 

9 


10 public class GoogleMapDemoActivity extends MapActivity 


11. private MapView mapView; 

12 private MapController mapController; 

13 

14 @ Override 

15 public void onCreate (Bundle savedInstanceState) { 
16 super.onCreate (savedInstanceState); 

AT setContentView(R.layout.activity main); 

18 


19 mapView- (MapView)findViewById (R.id.mapview); 
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20 mapController=mapView.getController (); 
21 

22 Double 1ng-126.676530486 * 1Е6; 

23 Double lat= 45.7698895661 * 1Е6; 

24 GeoPoint point- new GeoPoint (lat.intValue (), lng.intValue()); 
25 

26 mapController.setCenter (point); 

27 mapController.setZoom(11); 

28 mapController.animateTo (point); 

29 

30 mapView.setSatellite (false); 

31 } 

32 

33 @override 

34 protected boolean isRouteDisplayed () ( 

35 //TODO Auto- generated method stub 

36 return false; 

37 } 

38 } 


代码 第 20 行 获取 了 MapController, 用 以 在 第 26 行 设 置 MapView 的 “预订 显示 中 
点 ”, 在 第 27 行 设置 放 到 层级 ,在 第 28 行将 MapView 的 实际 显示 中 心 移动 到 第 26 行 设 
置 的 “预订 显示 中 心 ”。 代 码 第 22 行 和 第 23 行 设 置地 理 坐 标点 的 经 度 为 126. 676530486 
* 1E6、 纬 度 为 45.7698895661 * 1E6。 但 在 代码 第 26 行 , 没 有 直接 使 用 这 个 坐标 的 ,而 
是 将 其 转化 为 GeoPoint 再 使 用 。 代 码 30 行 是 设 定 MapView 的 地 图 显示 模式 是 否 为 卫 
星 模式 , 设置 true 则 为 卫星 模式 ,设置 false 则 为 普通 模式 。 代 码 第 34 行 
isRouteDisplayed() 方 法 ,是 用 来 统计 程序 是 否 显示 在 Google 地 图 中 显示 路 径 信息 ,默认 
为 不 显示 o 

运行 前 还 需要 在 AndroidManifest. xml 文件 中 添加 地 图 库 文件 的 引用 说 明 ( 下 方 代 
码 第 21 行 ) 和 人 允许 访问 互联 网 的 许可 (下 方 代码 第 8 行 ), 原 因 是 获取 Google 地 图 是 需要 
使 用 互联 网 的 。 

AndroidManifest. xml 文件 的 完整 代码 如 下 。 


«?xml version= "1.0" encoding- "utf- 8"?> 

«manifest xmlns:android- "http://schemas.android.com/apk/res/android" 
package- "edu .hrbeu.GoogleMapDemo" 
android:versionCode- "1" 


«uses- sdk android:minSdkVersion- "14" /> 


x 

2 

3 

4 

5 android:versionName- "1.0" » 

6 

1 

8 <uses- permission android:name- "android.permission.INTERNET"/> 
9 


10 <application 


11 
12 
13 
14 
15 
16 
XT 
18 
19 
20 
21 
22 


23 
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android:icon- "ё drawable/ic launcher" 
android:label- "@ string/app name" > 
«activity 
android:label- "6 string/app name" 
android:name- ".GoogleMapDemoActivity" > 
< intent- filter > 
« action android:name- "android.intent.action.MAIN" /> 
< category android:name- "android.intent.category.LAUNCHER" /> 
« /intent- filter» 
« /activity» 
« uses- library android:name- "com.google.android.maps"/» 
« /application» 


< /manifest» 


最 后 ,程序 运行 时 需要 连接 互联 网 ,运行 结果 如 图 9. 8 所 示 。 


GoogleMapDemo GoogleMapDemo 
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(a) 地 图 模式 (b) 卫星 模式 
图 9.8 GoogleMapDemo 示例 运行 结果 


923 地 图 上 使 用 覆盖 层 


在 很 多 的 地 图 应 用 中 都 需要 在 地 图 上 显示 信息 或 绘制 图 形 。 通 过 在 MapView ЕЙ 
加 覆盖 层 ， ice ton Google 地 
图 上 可 以 加 入 多 个 覆盖 层 , 所 有 覆盖 层 均 都 在 地 图 图 层 之 上 ,每 个 覆盖 层 均 可 以 对 用 户 
的 点 击 事件 做 出 响应 。 


eH 


覆盖 层 继承 Overlay 类 的 子 类 ,并 通过 重 载 draw() 方 法 为 指定 位 置 添 加 注解 ， 
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重 载 onTap() 方 法 处 理 用 户 的 点 击 操作 。 
下 面 的 代码 是 创建 Overlay 的 最 小 代码 集合 。 


1 public class TextOverlay extends Overlay ( 

2 @ Override 

3 public void draw (Canvas canvas, MapView mapView, boolean shadow) { 
4 if (shadow== false) { 

5 

6 } 

$ else{ 

8 } 

8 super.draw (canvas, mapView, shadow); 

10 } 

11 

12 @override 

13 public boolean onTap (GeoPoint p, MapView mapView) ( 
14 return false; 

15 ) 

16 } 


在 代码 第 3 行 的 draw O Jr ik P shadow 变量 是 用 来 区 分 绘制 不 同 的 图 层 , 如果 
shadow 为 false, 则 表示 在 覆盖 层 上 进行 绘制 ,反之 则 表示 在 隐藏 层 上 进行 绘制 。 代 码 的 
第 14 行 是 onTap() 方 法 的 返回 值 , 返 回 false 表示 覆盖 层 不 处 理 点 击 事件 ,返回 true 则 
表示 已 经 处 理 了 点 击 事件 。 

在 覆盖 层 绘制 图 形 或 文字 需要 使 用 "画布 "(Canvas) 来 实现 ,绘制 的 位 置 是 屏幕 坐 
ER ,这 就 需要 将 地 图 上 的 物理 坐标 与 屏幕 坐标 进行 转换 。Projection 类 提供 了 物理 坐标 
和 屏幕 坐标 的 转换 功能 ,可 在 经 度 和 纬度 表示 的 GeoPoint 点 与 屏幕 上 Point 点 进行 转 
换 。 其 中 ,toPixels() 方 法 将 物理 坐标 转换 为 屏幕 坐标 ,fromPixels() 方 法 将 屏幕 坐标 转 
换 为 物理 坐标 ,具体 使 用 方法 可 以 参考 下 面 的 代码 。 


* Projection projection- mapView.getProjection(); 
2 

3 projection.toPixels (geoPoint, point); 

4 projection.fromPixels (point.x, point.y); 


下 面 的 内 容 以 MapOverlayDemo 示例 ,说 明 如 何在 Google 地 图 上 添加 覆盖 层 , 并 在 
预订 的 物理 坐标 上 显示 提示 信息 。MapOverlayDemo 示例 的 运行 结果 如 图 9. 9。 

TextOverlay 类 是 MapOverlayDemo 示例 的 覆盖 层 , 主 要 重 载 了 draw() 方 法 ,在 指 
定 的 物理 坐标 上 绘制 了 标记 点 和 提示 文字 。 

TextOverlay. java 文件 的 核心 代码 如 下 。 

1 public class TextOverlay extends Overlay { 


2 private final int mRadius=5; 
3 
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MapOverlayDemo 
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Google 
9.9 MapOverlayDemo 运行 结果 


@override 
public void draw (Canvas canvas, MapView mapView, boolean shadow) ( 


Projection projection=mapView.getProjection (); 


if (shadow== false) { 
Double 1ng=126.676530486 * 1E6; 
Double lat=45.7698895661 * 1E6; 
GeoPoint geoPoint-new GeoPoint (lat.intValue (), lng.intValue()); 


Point point- new Point () ; 


projection.toPixels (geoPoint, point); 


RectF oval- new RectF (point. x- mRadius, point. y- mRadius, point. x+ 
mRadius, point.y-*mRadius); 


Paint paint- new Paint (); 
paint.setARGB (250, 250, 0, 0); 
paint.setAntiAlias (true); 
paint.setFakeBoldText (true); 


canvas.drawOval (oval, paint); 
canvas.drawText ("标记 点 ", point.x*2* mRadius, point.y, paint); 
} 


super .draw (canvas, mapView, shadow); 
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28 

29 @ Override 

30 public boolean onTap (GeoPoint p, MapView mapView) { 
31 return false; 

32 } 

3 J 


代码 第 2 行 定义 了 绘制 半径 变量 mRadius, 供 定义 绘制 范围 使 用 ;代码 第 14 行使 用 
Projection 完成 了 从 物理 坐标 到 屏幕 坐标 的 转换 ;第 19 行 设置 了 绘制 颜色 ;第 20 行 开 启 
了 平滑 设置 ,防止 文字 出 现 锯齿 ;代码 第 23 行 绘制 了 圆 形 的 标记 点 ,标记 点 的 大 小 以 代 
码 第 16 行 设 定 的 oval 为 准 ; 代 码 第 24 行 绘制 了 提示 文字 ,第 2 个 和 第 3 个 参数 是 绘制 
屏幕 的 x 坐标 和 y 坐标 。 

建立 了 覆盖 层 后 ,还 需要 把 覆盖 层 添 加 到 MapView 上 。MapOverlayDemoActivity. 
java 的 核心 代码 如 下 。 


1 public class MapOverlayDemoActivity extends MapActivity { 


2 private MapView mapView; 


3 private MapController mapController; 

4 private TextOverlay textOverlay; 

5 

6 @ Override 

7 public void onCreate (Bundle savedInstanceState) { 
8 super.onCreate (savedInstanceState); 

9 setContentView (R.layout.main); 

10 

11 mapView- (MapView)findViewById (R.id.mapview); 
12 mapController-mapView.getController (); 

13 

14 Double 1ng-126.676530486 * 1E6; 

15 Double lat-45.7698895661 * 1E6; 

16 GeoPoint point- new GeoPoint (lat.intValue (), lng.intValue()); 
17 

18 mapController.setCenter (point); 

19 mapController.setZoom(11); 

20 mapController.animateTo (point); 

21 

22 textOverlay- new TextOverlay () ; 

23 List<Overlay>overlays=mapView.getOverlays () ; 
24 overlays.add(textOverlay); 

25. | 

26 

27 @ Override 

28 protected boolean isRouteDisplayed () { 


29 return false; 


Os 位 置 服务 与 地 图 应 用 


代码 第 22 行 实例 化 了 TextOverlay 对 象 ;在 第 23 行 通过 getOverlays() 方 法 ,获取 
MapView 已 有 的 覆盖 层 ; 在 第 24 行使 用 add() 方 法 将 TextOverlay 对 象 添加 到 
MapView 中 。 


= En 
1. 讨论 位 置 服务 和 地 图 应 用 的 发 展 前 景 。 


2. 编程 实现 轨迹 追踪 软件 。 每 间隔 60 秒 , 同 时 距离 移动 大 于 1 米 的 情况 下 ,记录 一 
次 位 置信 息 ,在 Google 地 图 上 绘制 600 秒 的 行动 轨迹 。 
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Widget 是 一 种 可 被 嵌入 其 他 程序 的 视图 ,并 可 收 周 期 性 进行 更 新 。 随 着 Android 平 
板 电脑 和 其 他 大 屏幕 设备 的 出 现 , Widget 越 来 越 广泛 被 用 于 开发 主屏 幕 的 信息 显示 程 
序 。 通 过 本 章 的 学 习 , 读 者 可 以 了 解 Widget 的 概念 ,特征 和 用 途 , 并 掌握 其 具体 的 开发 
方法 和 配置 方法 。 

本 章 学 习 目 标 : 

。 了 解 Widget 的 概念 及 特征 ; 

。 掌握 Widget 的 设计 原则 和 开发 步骤 ; 

* 了 解 Widget 的 调试 方法 ; 

。 掌握 使 用 Activity 配置 Widget 的 方法 ; 

。 掌握 使 用 Service 更 新 Widget 的 方法 。 


101 Widget 简介 


Widget 是 一 个 具有 特定 功能 的 视图 ,一 般 被 嵌入 主屏 幕 (Home screen) 中 ,用 户 在 
不 启动 任何 程序 的 前 提 下 ,就 可 以 在 主屏 幕 上 直接 浏览 Widget 所 显示 的 信息 。Widget 
在 主屏 幕 上 显示 自 定义 的 界面 布局 ,在 后 台 周 期 性 地 更 新 数据 信息 ,并 根据 这 些 更 新 的 
数据 修改 主屏 幕 的 显示 内 容 。Widget 可 以 有 效 地 利用 手机 的 屏幕 ,快捷 方便 地 浏览 信 
息 ,为 用 户 带 来 良好 的 交互 体验 。 

Widget 是 Android 1. 5 引入 的 新 特性 ,发展 到 Android 4. 0 已 经 有 很 大 的 进步 和 改 
变 , 例 如 在 Android 3.1 引 入 的 更 改 Widget 尺寸 功能 ,以 及 Android 4. 0 增加 的 自动 设 
置 边 界 功能 。Widget 在 主屏 幕 上 可 以 出 现 多 个 相同 的 副本 ,也 可 以 根据 用 户 的 设置 , 产 
生 尺 十 ,布局 .刷新 速率 和 更 新 逻辑 完全 不 同 的 副本 ,如 图 10. 1 所 示 。 将 Widget 程序 设 
计 成 多 个 界面 风格 的 版 本 ,有 助 于 适应 不 同 用 户 的 喜好 。 

目前 ,在 Android 智能 手机 和 平板 电脑 上 具有 非常 广泛 的 应 用 ,包括 用 Widget 实现 
的 微 博客 RSS 订阅 器 、 股 市 信息 .天 气 预报 日历. 时钟. 信息 提醒 .电量 显示 .邮件 、 便 
3 .音乐 播放 .相册 和 新 闻 等 。 

在 Android 系统 中 , 自 带 了 多 个 Widget 程序 ,包括 时 钟 、 书 签 .音乐 播放 器 .相框 和 
搜索 栏 等 ,如 图 10.2 所 示 。 在 Widget 列表 中 可 以 查看 所 有 的 Widget 组 件 ,通过 长 时 间 点 
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击 Widget 组 件 , 可 以 将 Widget 组 件 添加 到 主屏 幕 上 。 


LETT 


Рат Berry 
The Shins 


mes. Inbox = 
一 anis@example com 
me, John 2 10252m| 


Happy birthday! - Thanks! 


Mary, me 2 "d 
Don't forgeti = Yes thanks for reminding 
The Emperor Sep 17 日 历 2x3 ”设置 快捷 方式 
Battiestation plans ми ure to plug 
that hole we talked abc 

图 10.1 各 种 Widget 10.2 Android 4. 0 中 的 Widget 


102 Widget 基础 


1021 设计 原则 


Widget 是 主屏 幕 上 的 显示 元 素 , 不 仅 自 身 具 有 一 定 的 设计 规则 ,还 要 与 主屏 幕 上 其 
他 的 元 素 保持 美观 一 致 。 

Widget 显示 在 主屏 幕 上 的 结构 如 图 10.3 所 示 。 最 外 层 是 单元 格 边界 ,这 个 边界 是 
不 同 Widget 的 分 隔 界 限 ,在 界面 上 这 个 界限 Widget Margins Widget Padding 
对 用 户 是 不 可 见 的。 框架 边界 是 Widget 背景 
图 像 的 界限 ,背景 图 线 会 填充 满 整 个 框架 
(Frame)。 最 里 面 是 Widget Controls ,这 是 显 

示 Widget 界面 元 素 的 空间 。 

Widget Padding 是 框 架 边 界 与 Widget 
Controls 之 间 的 距离 ,可 将 Widget 的 界面 元 
素 显 示 在 背景 图 片 的 中 间 区 域 。 

为 了 保证 多 个 Widget 显示 时 不 会 靠 得 太 
近 , 一 般 都 会 设 定 Widget Margins, 这 个 值 是 
单元 格 边 界 与 框架 边界 的 距离 。 如 果 Widget 图 10.3 Widget 构成 
Margins 的 值 为 0, 则 两 个 Widget 就 会 连 在 一 


单元 格 边 界 框架 边界 
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起 。 在 Android 4. 0 中 ,系统 会 自动 在 添加 Margins ,保持 两 个 Widget 可 以 保持 一 定 的 
间隔 距离 。 笔 者 建议 使 用 这 个 新 功能 ,方法 是 只 要 将 AnroidManifest. xml 文件 中 的 
targetSdkVersion 设置 为 14。 

下 面 介 绍 如 何 设计 出 同时 适应 Android 4.0 以 及 较 早 Android 系统 的 Widget 界面 
布局 ,使 之 在 较 早 的 Android 系统 上 具有 自 定义 的 Widget Margins 值 ,而 在 Android 4.0 
上 保持 相同 的 显示 方式 ,而 不 会 因为 Android 4.0 自动 添加 边界 间隔 而 出 现 显示 不 一 致 
的 情况 。 具 体 方法 如 下 : 

(OD 首先 ,将 AnroidManifest. xml 文件 中 的 targetSdkVersion 设置 为 14。 

(2) 建立 布局 文件 ,引用 dimension 资源 ,布局 文件 如 下 。 


< FrameLayout 
android:layout width- "match parent" 
android:layout height- "match parent" 
android:layout margin- "ё dimen/widget margin" 


1 
2 
3 
4 
5 
6 «X LinearLayout 

7 android:layout width= "match parent" 
8 android:layout height- "match parent" 
9 


android:orientation- "horizontal" 

10 android:background- "@ drawable/widget background"> 
11 < /LinearLayout> 

12 </FrameLayout> 


(3) 建立 两 个 dimension 资源 ,第 1 个 在 /res/values 目录 下 ,为 较 早 的 Android 系统 
提供 自 定义 的 Margins; 第 2 个 在 /res/values-v14 目录 下 ,为 Android 4. 0 系统 设 定 
Margins, 


res/values/dimens. xml; 

<dimen name= "widget margin"» 15dp< /dimen> 
res/values-v14/dimens. xml: 

<dimen name= "widget _ margin"> 0dp< /dimen> 


Android 系统 将 主屏 幕 划分 为 单元 格 ,单元 格 的 大 小 和 数量 会 随 设 备 的 变化 而 完全 
不 同 ,一般 智能 手机 会 被 划分 为 4X4 的 单元 格 ,而 平板 电脑 一 般 会 被 划分 为 8X7 的 单 
元 格 。 当 用 户 将 Widget 加 入 到 主屏 幕 时 ,Widget 会 占据 一 定数 量 的 单元 格 ,占据 单元 格 
的 数量 由 minWidth 和 minHeight 决定 ,这 两 个 属性 是 默认 情况 下 Widget 的 显示 尺寸 ， 
具体 的 计算 方法 可 以 查 表 10. 1。 其 中 ,dp 表示 与 设备 无 关 的 像素 ,计算 公式 中 之 所 以 要 
减 去 30 ,是 因为 了 防止 像素 计算 时 的 整数 舍 人 导致 错误 。 

在 设 定 minWidth 和 minHeight 时 ,最 基本 的 原则 是 使 Widget 处 于 最 佳 的 显示 状 
态 。 下 面 以 “音乐 播放 器 ”为 例 说 明 如 何 计算 Widget 的 minWidth 和 minHeight 值 。 音 
乐 播放 器 的 界面 如 图 10.4 所 示 。 
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表 10.1 Widget 尺寸 的 计算 方法 


(< MEE Lo 单元 格 数量 
40dp 1 
110dp 2 
180dp 3 
250dp 4 
70 * n—30 n 


音乐 播放 器 的 由 一 个 显示 歌曲 信息 的 TextView 和 两 个 控制 音乐 播放 的 按钮 组 成 。 
音乐 播放 器 的 界面 元 素 尺寸 如 图 10.5 所 示 。minWidth 应 等 于 三 个 控件 的 宽度 和 ,加 上 
控件 之 间 的 空隙 ,minHeight 应 等 于 TextView 控件 的 高 度 加 上 边界 空隙 。 具 体 的 计算 
方法 可 以 参考 下 面 的 公式 : 
minWidth = 1444р + (2 X 84р) + (2 X 56dp) = 2724р 
minHeight = 48dp 十 (2 X 44р) = 56dp 


The song title... D 
itle... Arti 
a 2 = — — E= 


图 10.4 音乐 播放 器 的 界面 10.5 音乐 播放 器 的 界面 元 素 尺 十 


ар 


为 了 增加 Widget 对 不 同 屏幕 尺寸 和 单元 格 尺寸 的 适应 性 ,建议 尽量 使 用 具有 自 适 
应 能 力 的 布局 ,例如 线性 布局 .相对 布局 或 框架 布局 。 而 且 在 设计 界面 元 素 时 ,将 不 可 改 
变 尺寸 的 界面 元 素 的 高 度 和 宽度 设置 成 固定 值 ,而 让 尺寸 可 改变 的 界面 元 素 填 充 全 部 剩 
余 空间 。 例 如 在 音乐 播放 器 的 界面 中 ,将 两 个 按钮 的 尺寸 固定 ,而 将 TextView 的 宽度 设 
置 为 可 变 的 ,并 允许 TextView 在 横向 上 占据 所 有 可 用 的 空间 ,而 为 了 美观 TextView 的 
高 度 应 该 固定 。 最 后 ,应 保证 所 有 界面 元 素 在 纵向 上 居中 显示 。 

当 Widget 的 尺寸 不 够 填充 满 所 应 占 的 单元 格 时 ,Widget 会 在 横向 和 纵向 拉 伸 ,以 填 
充 所 有 应 该 占据 的 单元 格 。 图 10. 6 是 音乐 播放 器 在 单元 格 尺寸 为 80dp X 100dp， 
Margins 为 16 的 显示 效果 。 


The song title in full 
Song Artist » >м 


图 10.6 音乐 播放 器 在 80dpX100dp 单元 格 中 的 显示 效果 
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最 后 ,建议 读者 使 用 9-patche 文件 作为 背景 图 像 ,文件 扩展 名 为 . 9. png。 这 种 图 像 
文件 可 以 自动 填充 整个 背景 空间 ,同时 不 会 影响 界面 的 美观 。 

读者 可 以 在 下 面 的 地 址 下 载 Widget 模板 包 ( 如 图 10. 7 所 示 ) ,模板 包 里 面包 括 
NinePatch 81 X fF , XML 文件 和 Photoshop 源 文件 等 内 容 , 适 用 于 不 同 屏幕 解析 度 和 
Android 版 本 系统 。 下 载 地 址 为 http://developer. android. com/shareables/app_widget 


_templates-v4. 0. zip。 


10.7 Widget 模板 包 
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在 介绍 了 Widget 的 基础 框架 类 后 ,简单 说 明 Widget 的 一 般 开发 步骤 : 

(1) 设计 Widget 的 布局 ; 

(2) 定义 Widget 的 元 数据 ; 

(3) 实现 Widget 的 添加 、 删 除 、 更 新 ; 

(4) 在 AnroidManifest. xml 文件 中 声明 Widget。 

下 面 以 SimpleWidget 为 例 , 介 绍 Widget 的 开发 步骤 ,以 及 Widget 框架 类 中 各 个 函 
数 的 调用 顺序 。 


1. 设计 Widget 的 布局 


创建 用 户 Widget 的 第 一 步 是 设计 并 实现 Widget 的 组 件 布局 ,就 是 Widget 和 用 户 
交互 的 界面 。SimpleWidget 示例 设计 目标 如 图 10. 8 Bros ,背景 使 用 NinePatch 的 PNG 
图 片 , 内 部 为 白色 背景 ,具有 浅 蓝 色 的 边框 。Widget 内 部 包含 TextView 和 ImageButton 
控件 ,使 用 线性 水 平 布局 。 


TextView 所 占用 的 空间 为 浅 蓝 色 区 域 ej) 


图 10.8 SimpleWidget 示例 的 设计 目标 


Widget 与 Activity 的 布局 设计 和 实现 方法 上 十 分 相似 ,都 是 在 /res/layout 目录 中 


建立 基于 XML 的 布局 资源 文件 。SimpleWidget 示例 建立 的 Widget 布局 文件 的 文件 名 
为 widget layout. xml, 将 Widget 背景 图 片 放 置 在 /res/drawable 目录 中 ,文件 名 为 
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widget_background. 9. png. 
下 面 给 出 widget_layout. xml 的 完整 代码 。 


£ 
2 
y 
4 
5 
6 
7 
8 
9 
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<?xml version= "1.0" encoding- "utf- 8"? > 
< LinearLayout xmlns:android= "http://schemas .android.com/apk/res/android" 


android:layout_width="fill parent" 
android:layout_height="fill parent" 
android:orientation="horizontal" 
android:background- "@ drawable/widget background" 
android:padding- "8ар"> 


«TextView android:id- "ё id/label" 
android:layout width- "wrap content" 
android:layout height- "48dp" 


android:text- "TextView 所 占用 的 空间 为 浅 蓝 色 区 域 " 


android:textColor- "@ color/black" 
android:background- "8 color/lightskyblue" 
android:layout weight- "1" 


android:layout gravity- "center vertical"/» 


< ImageButton 
android:id- "ё + іа/ітаде button" 
android:layout width- "48dp" 
android:layout height- "48dp" 
android:src- "ё drawable/button image" 
android:layout gravity- "center vertical"/» 


25 «/Linearlayout» 


代码 第 13 行将 TextView 的 字体 颜色 设置 为 黑色 ,代码 第 14 行将 TextView WE 
景 颜 色 设置 为 浅 蓝 色 , 主 要 用 来 确定 TextView 所 占据 的 区 域 范 围 。 代 码 第 15 行将 
layout. weight 设 为 1, 而 没有 在 ImageButton 中 设置 这 个 参数 ,表明 Text View 控件 会 占 


据 父 节点 所 拥有 的 剩余 空间 。 
在 Eclipse 的 界面 控制 器 中 ,Widget 的 显示 效果 与 设计 目标 略 有 区 别 , 如 图 10.9 所 


示 ,主要 原因 是 线性 布局 的 layout. width 和 layout. height 属性 都 被 设置 成 fill parent. 
出 于 Widget 的 安全 和 性 能 考虑 , Widget 支持 的 布局 和 控件 存在 一 些 限制 。 目 前 
Widget 支持 的 布局 有 框架 布局 、 线 性 布局 和 相关 布局 ;支持 的 界面 控件 有 AnalogClock、 


Button, Chronometer, ImageButton, ImageView. ProgressBar, TextView, ViewFlipper, 


ListView,GridView,StatckView 和 AdapterViewFlipper, 


2. ЖУ Widget 的 元 数据 


Widget 元 数据 定义 了 Widget 最 基本 的 信息 ,包括 Widget 的 尺寸 .更 新 周期 ,布局 文 


262 Улак аня (Ж ЗА) 


< — Palette — 


а +] @неш -| B ~| жнь -| @ iseen -| € -| Фа ~ 
@ са | 


E Graphical Layout | F] widget layoutxml| 


10.9 界面 设计 器 中 显示 效果 


件 位 置 .预览 图 片 . 拉 伸 方向 和 配置 界面 等 。 
SimpleWidget 示例 Widget 元 数据 的 文件 保存 在 /res/xml/widget_template. xml 
中 ,该 文件 的 完整 代码 如 下 。 


1 < ?xm1 version- "1.0" encoding- "utf- 8"?> 

2 « appwidget- provider 

3 xmlns:android- "http: //schemas.android.com/apk/res/android" 
4 android:minWidth- "150dp" 

5 android:minHeight- "60dp" 
6 

7 

8 

9 


android:resizeMode- "horizontal |vertical" 
android:minResizeHeight- "80dp" 
android:minResizeWidth- "48dp" 
android:updatePeriodMillis- "36000" 
10 android:initialLayout- "ё layout/widget layout" 
11 android:previewImage= "@ drawable/preview" 
12 /> 
代码 第 2 行使 用 appwidget-provider 标签 声明 了 Widget 的 元 数据 。 代 码 第 4 行 和 
第 5 行 定义 了 Widget 的 两 个 关键 属性 ,minWidth 和 minHeight 分 别 表示 默认 情况 下 
Widget 的 显示 宽度 和 高 度 , 也 就 是 Widget 在 拖 中 到 主屏 幕 时 的 尺寸 。 
Android 3. 1 后 的 系统 支持 改变 Widget 的 显示 尺寸 ,代码 第 6 行 声明 Widget 的 尺 
寸 可 变 ,horizontal| vertical 表示 在 水 平和 垂直 方向 上 的 大 小 都 是 可 以 变化 的 。 其 中 ,不 
可 调整 .水 平方 向 调整 .垂直 方向 调整 水平 与 垂直 方向 调整 ,这 四 种 方式 的 参数 分 别 为 
none, horizontal, ,vertical ,horizontal | vertical, 


在 代码 第 7 行 和 第 8 行 中 ,Widget 的 最 小 尺寸 由 minResizedWidth 和 minResizedHeight 
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决定 。minResizeHeight 是 Widget 能 够 重新 设置 的 最 小 高 度 ,此 值 在 大 于 minHeight 
时 ,或 resizeMode 中 不 支持 垂直 (vertical) 拖 电 时 ,此 属性 不 起 作用 。minResizeWidth 是 
Widget 能 够 重新 设置 的 最 小 宽度 ,此 值 在 超过 min Width 时 ,或 者 resizeMode 不 支持 水 
平 (horizontal) 拖 电 时 ,此 属性 不 起 作用 。 

代码 第 9 行 的 updatePeriodMillis 表示 以 毫秒 为 单位 的 更 新 周期 ,Android 会 以 这 个 
速率 唤醒 设备 以 便 更 新 Widget, 开 发 人 员 应 尽 
可 能 地 降低 设备 被 唤醒 的 次 数 ,以 降低 设备 的 能 
量 消 耗 。 当 更 新 周期 小 于 30 分 钟 时 , Android 
系统 并 不 按照 此 参数 更 新 Widget, 如 果 需 要 频 
繁 更 新 Widget, 可 以 在 Service 服务 中 实现 。 

代码 第 10 行 的 initialLayout 用 来 指定 
Widget 的 布局 。 代 码 第 11 行 的 previewImage 10.10  SimpleWidget 示例 的 预览 图 像 
定义 了 在 Android 系统 Widget 列表 中 预览 图 
像 , 如 果 不 设置 该 值 , 则 以 程序 的 图 标 作为 预览 图 像 。SimpleWidget 示例 的 预览 图 像 如 
图 10. 10 所 示 。 


3. 实现 Widget 的 添加 、 删 除 、 更 新 
实现 Widget 的 添加 、 删 除 、 更 新 等 过 程 ,主要 是 通过 AppWidgetProvider 类 来 实现 。 
这 个 类 本 身 继承 BrocastReceiver, 用 来 接收 与 Widget 相关 的 更 新 .删除 .生效 和 失效 等 
消息 , 当 AppWidgetProvider 接收 这 些 消 息 后 ,会 分 别 调用 响应 的 事件 处 理 函 数 , 如 
K 10. 2 所 示 。 
Ж 10.2 AppWidgetProvider 类 的 事件 处 理 函 数 


事 f 调用 函数 说 明 
ACTION_APPWIDGET_UPDATE onUpdate() Widget 更 新 
ACTION_APPWIDGET_DELETED onDelete() Widget 删除 
ACTION_APPWIDGET ENABLED onEnabled() Widget 生效 
ACTION_APPWIDGET_DISABLED onDisabled() Widget 失效 


在 SimpleWidget 示例 中 , WidgetProvider 继承 AppWidgetProvider 类 ,在 Widget 
更 新 ,删除 等 操作 过 程 中 调用 其 内 部 的 函数 。WidgetProvider. jva 文件 的 完整 代码 如 下 。 


package edu.hrbeu.SimpleWidget; 


import android.appwidget .AppWidgetManager; 


import android.appwidget .AppWidgetProvider; 
import android.util.Log; 


1 
3 
4 
5 import android.content.Context; 
6 
T 
8 public class WidgetProvider extends AppWidgetProvider { 
9 


private static final String TAG- "WIDGET"; 


264 


Ф... нз. (узж) 


10 


11 @ Override 

12 public void onUpdate (Context context, AppWidgetManager 
appWidgetManager, int[] appWidgetIds){ 

13 Log.d(TAG, "onUpdate"); 

14 } 

15 

16 @ Override 

17 public void onDeleted (Context context, int[] appWidgetIds)( 

18 Log.d(TAG, "onDeleted"); 

19 } 

20 

21 @ Override 

22 public void onEnabled (Context context) { 

23 Log.d(TAG, "onEnabled"); 

24 } 

25 

26 @ Override 

27 public void onDisabled (Context context) ( 

28 Log.d(TAG, "onDisabled"); 

29 } 

30 ] 


从 代码 中 不 难 发 现 ,虽然 重 载 了 的 onUpdate ()、onDelete С), onEnabled C) 和 
onDisabled() 四 个 函数 ,但 仅 在 函数 中 设置 了 调试 信息 ,后 期 可 以 利用 调试 信息 观察 这 些 
函数 何 时 会 被 调用 。 

onUpdate(Context, AppWidgetManager, int[ D 函数 在 updatePeriodMillis 定义 时 
间 间 隔 到 期 时 被 调用 ,主要 用 来 更 新 Widget 组 件 的 界面 显示 。 除 此 以 外 ,在 用 户 每 次 将 
Widget 拖 忠 到 主屏 幕 时 ,该 函数 也 会 被 调用 ,可 在 此 函数 中 为 界面 元 素 定义 按钮 点 击 事 
件 处 理 函 数 , 或 者 启动 一 个 临时 的 Service 进行 数据 获取 等 。 

onDeleted(Context context, int[ ] appWidgetIds) PR Zt J& 24 — 7. Widget 从 主屏 幕 上 
被 删除 时 调用 的 函数 ,用 来 回收 资源 。 

onEnabled(Context context) PR Zi fE У Widget 实例 被 创建 并 添加 到 主屏 幕 时 被 调 
用 。Widget 可 以 在 主屏 幕 上 创建 多 个 实例 ,但 只 有 在 第 一 个 Widget 实例 被 创建 时 才 调 
用 该 函数 。onEnabled() 一 般 用 来 进行 一 些 初始 化 工作 ,比如 打开 一 个 新 的 数据 库 ,或 者 
执行 对 所 有 Widget 实例 来 说 只 需 进行 一 次 的 设置 。 

onDisabled(Context context) 函数 在 最 后 一 个 Widget 实例 被 删除 时 调用 ,用 来 释放 
在 onEnabled() 中 使 用 的 资源 .如 删除 在 onEnabled O 函数 中 创建 临时 数据 库 。 

在 将 Widget 添加 到 主屏 幕 上 ,或 者 从 主屏 幕 删除 Widget 都 会 引发 
AppWidgetProvider 中 的 事件 处 理 函 数 。 以 Simple Widget 为 例 ,通过 观察 Eclipse 中 
LogCat 的 输出 信息 ,分 析 用 户 对 Widget 进行 不 同 操作 所 引发 的 事件 处 理 函 数 及 其 调用 
顺序 关系 。 
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当 Widget 第 一 次 添加 到 主屏 幕 时 ,系统 会 按 顺 序 调用 onEnable() 和 onUpdateO 。 
当 再 次 向 主屏 幕 添 加 Widget 时 ,系统 则 仅 调 用 onUpdate()。 当 从 主屏 幕 删除 Widget 
时 ,如 果 主 屏幕 还 有 这 个 Widget 的 实例 , 则 系统 仅 调 用 onDelete O ;如 果 被 删除 的 是 这 
个 Widget 的 最 后 一 个 实例 , 则 系统 在 调用 onDelete() 后 会 调用 onDisable() 。 


4. 在 AnroidManifest. xml 文件 中 声明 Widget 


最 后 ,要 让 Widget 生效 还 须 在 AnroidManifest. xml 文件 中 进行 声明 ,主要 在 该 文件 
中 声明 AppWidgetProvider 类 。AnroidManifest. xml 的 完整 代码 如 下 。 


É <?xml version- "1.0" encoding- "utf- 8"?» 

2 «manifest xmlns:android- "http: //schemas .android.com/apk/res/android" 

3 package- "edu .hrbeu.SimpleWidget" 

4 android:versionCode- "1" 

5 android:versionName- "1.0" » 

6 

ГА <uses- sdk android:minSdkVersion- "14" /> 

8 

9 <application 

10 android:icon- "8 drawable/ic launcher" 

11 android:label- "6 string/app папе" > 

12 «receiver android:name- ".WidgetProvider"» 

13 «meta- data android:name- "android.appwidget .provider" 

14 android:resource- "@ xml/widget template" /» 

15 «intent- filter» 

16 «action android: папе= "android.appwidget.action.APPWIDGET UPDATE" 
/> 

17 < /intent- filter» 

18 < /receiver» 

19 « /application» 


20 «/manifest» 


代码 第 12 行 声 明了 receiver Ж £, android: name 属性 定义 了 AppWidgetProvider 
的 子 类 。 代 码 第 13 fT meta-data 标签 中 的 android: name 属性 ,使 用 android. appwidget. 
provider 表示 这 里 的 数据 是 Widget 的 元 数据 。 代 码 第 14 行 的 android:resource 属性 声 
明了 元 数据 的 资源 路 径 。 代 码 第 15 行 定义 了 intent-filter 标签 ,代码 第 16 行 声明 接收 
ACTION_APPWIDGET_UPDATE 消息 。 


1023 调试 过 程 


在 完成 SimpleWidget 示例 的 所 有 代码 后 ,进入 Widget 的 调试 过 程 。 在 进行 Widget 
调试 前 ,首先 介绍 如 何 安装 、 加 载 和 删除 Widget 组 件 。 

安装 Widget 与 安装 其 他 程序 相似 ,是 通过 Eclipse 上 的 “运行 "(Run) 按 钮 启动 程序 
的 编译 ,链接 、 打 包 和 安装 过 程 ,唯一 区 别 是 在 Widget 安装 到 模拟 器 后 ,不 会 直接 出 现在 
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主屏 幕 上 ,而 需要 用 户 在 Android 系统 的 Widget 列表 中 手动 将 Widget 添加 到 主屏 幕 
E. Android 系统 的 Widget 列表 如 图 10. 11 所 示 。 


T 


Fa G 1043 


图 10.11 Android 系统 的 Widget 列表 


用 户 通过 长 时 间 ( 超 过 2 秒 ) 点 击 SimpleWidget 的 预览 图 标 , 将 SimpleWidget 实例 
加 载 到 主屏 幕 上 ,默认 情况 下 占据 25x 1 个 单元 格 , 如 图 10. 12(a) 所 示 。 
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(а) 初始 尺寸 (b) 拉 伸 效果 
图 10.12 SimpleWidget 示例 效果 图 


在 主屏 幕 上 ,通过 长 时 间 点 击 SimpleWidget 实例 ,可 以 进入 调整 Widget 尺寸 状态 ， 
如 图 10. 12(b) 所 示 ,Widget 边缘 出 现 4 个 实心 萎 形 ,通过 拖 中 这些 实心 菱形 ,可 以 调整 
Widget 的 尺寸 。SimpleWidget 实例 在 图 10. 12(b) 中 ны 1х2 个 单元 格 。 
如 果 和 希望 添加 第 二 个 Simple Widget 实例 ,过 程 与 添加 第 一 个 SimpleWidget 实例 的 
过 程 完全 相同 。 
在 希望 删除 Widget 时 ,同样 是 通过 长 时 间 点 了 幕 上 的 Widget 实例 ,主屏 幕 上 
了 会 会 出 现 垃圾 桶 ,直接 将 Widget 实例 拖 到 垃圾 桶 即 可 。 需 要 注意 的 是 ,主屏 幕 上 的 垃 
圾 桶 是 隐藏 的 ,需要 通过 长 时 间 点 击 Widget 示例 才 会 出 现 。 当 Widget 实例 在 垃圾 桶 上 
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方 呈 现 出 红色 时 , 松 开 手指 便 可 完成 删除 操作 。 
103 Widget 配置 


在 Widget 的 使 用 过 程 中 ,有 时 用 户 需要 根据 个 人 喜好 设置 Widget 的 不 同 特 征 , 如 
Widget 的 外 观 风格 、 字 体 颜 色 、 字 体 大 小 、 更 新 时 间或 背景 图 案 等 。 比 较 普遍 的 做 法 是 在 
Widget 添加 到 主屏 幕 时 ,启动 一 个 用 于 配置 Widget 的 Activity, 用 户 在 这 个 Activity 中 
设 定 Widget 的 特征 。 

配置 Widget 特征 的 Activity, 需 要 在 Widget 元 数据 XML 文件 中 进行 声明 ,声明 的 
属性 为 android:configure, 其 值 为 Activity 所 在 的 类 ,示例 代码 如 下 。 


1 «?xml version- "1.0" encoding- "utf- 8"?» 

2 « appwidget- provider 

3 xmlns:android- "http: //schemas.android.com/apk/res/android" 
4 шә 
5 

6 


android:configure- "edu.hrbeu.ConfigWidget .ConfigActivity" 
/> 


在 代码 第 5 行 中 ,Activity 使 用 了 带 命名 空间 (edu. hrbeu. ConfigWidget) 的 声明 方 
式 , 这 是 因为 调用 Activity 的 Widget 宿主 与 Activity 并 不 在 相同 的 命名 空间 中 。 

元 数据 中 声明 的 Activity. ESA Widget 实例 被 添加 到 主屏 幕 前 会 被 启动 。 当 用 户 
完成 配置 选择 关闭 Activity, Widget 才 会 出 现在 主屏 幕 上 。 

用 户 配 置 Widget 的 Activity 也 需要 在 AndroidManifest. xml 文件 中 声明 。 不 同 于 
声明 普通 的 Activity, 这 种 Activity 是 被 Widget 的 宿主 通过 发 送 android. appwidget. 
action. APPWIDGET CONFIGURE 动作 (Action) 启 动 的 ,所 以 此 Activity 需要 接收 
Intent 消息 ,示例 代码 如 下 。 


«activity android:name=".ConfigActivity"> 


1 
2 < intent- filter> 
3 


<action android:name= "android.appwidget.action 


-APPWIDGET CONFIGURE" /> 


> 


< /intent- filter» 

5  «/activity» 

当 用 户 使 用 Activity 完成 Widget 的 配置 后 , Activity 有 责任 调用 相应 代码 对 
Widget 进行 更 新 ,Activity 可 以 直接 调用 AppWidgetManager 类 更 新 Widget, 也 可 调用 
开发 人 员 在 AppWidgetProvider 中 编写 的 静态 更 新 函数 ,实现 Widget 的 更 新 。 
AppWidgetManger 是 负责 管理 Widget 的 类 .向 AppWidgetProvider 发 送 通 知 。 

要 实现 使 用 Activity 配置 Widget 特征 ,并 在 适当 的 时 候 更 新 Widget, 可 以 参考 如 下 步骤 。 


1. 获取 Widget 的 ID 


Widget 的 宿主 在 启动 Activity 时 ,将 Widget 的 ID 保存 在 Intent 中 ,通过 调用 
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extras. getInt O 函数 获取 Widget 的 ID. 

extras. getInt( String key, int defaultValue) PR Zi. 2 1 是 获取 数据 的 关键 字 ,应 
使 用 关键 字 appWidgetId, 或 AppWidgetManager. EXTRA_APPWIDGET_ID; 参 数 2 是 
无 法 获取 数据 时 函数 返回 的 代替 数据 ,示例 代码 如 下 。 
Intent intent=getIntent (); 


Bundle extras= intent .getExtras (); 
if(extras!-null)( 


шю P> 


mAppWidgetId- extras.getInt (AppWidgetManager.EXTRA APPWIDGET ID, 
AppWidgetManager.INVALID APPWIDGET ID); 

} 

if (mAppWidgetId==AppWidgetManager .INVALID APPWIDGET ID)( 


finish(); 


о чао 0 


} 


代码 第 4 行 的 AppWidgetManager. INVALID. APPWIDGET ID 的 值 为 0, 表示 没 
有 获取 到 Widget 的 ID。 代码 第 6 行 和 第 7 行 说 明 ,在 没有 正确 获取 到 Widget 的 ID В]. 
可 以 立即 关闭 Activity, 因 为 没有 正确 的 ID, 即使 完成 配置 工作 ,也 无 法 将 配置 信息 正确 
传递 回 Widget。 


2. BiE Widget 

在 配置 Widget 过 程 中 用 户 会 在 界面 上 选择 相应 的 配置 方案 和 配置 信息 ,并 最 终 通 
过 事件 引发 更 新 Widget 过 程 ,并 关闭 Activity。 

3. 更 新 Widget 


在 更 新 Widget 时 ,首先 通过 调用 getInstance(context) 函数 获取 AppWidgetManager 实 
例 ;然后 建立 一 个 RemoteViews, 在 这 个 RemoteViews 上 更 改 Widget 的 界面 元 素 ;最 后 调用 
updateAppWidget(int, views) 函数 完成 Widget 更 新 。RemoteViews 是 可 在 其 他 进程 中 显示 
的 视图 类 ,提供 对 部 分 界面 控件 的 最 基本 的 操作 。 示 例 代码 如 下 。 


1 AppWidgetManager appWidgetManager- AppWidgetManager.getInstance (context); 
2 RemoteViews views- new RemoteViews (context .getPackageName (), 


R.layout.widget layout); 
3  views.setTextColor(R.id.label,textColor); 
4  appiWidgetManager.updateAppWidget (appidgetId, views); 
代码 第 2 行 的 R. layout. widget layout 是 Widget 的 布局 。 代 码 第 3 17 setTextColor О 
函数 可 以 设置 Text View 控件 的 字体 颜色 ,TextView 控件 的 ID 为 R. id. label,textColor 
是 代表 颜色 的 Int 型 整数 。 代 码 第 4 行 的 updateAppWidget() 函 数 中 ,参数 1 是 Widget 
的 ID, 参数 2 是 刚 建立 的 RemoteViews。 


4. 设置 返回 信息 ,并 关闭 Activity 


Ti 


In pese sr 


通过 调用 setResult(int resultCode. Intent data) ER Zt. iE 9 Activity 的 返回 代码 和 
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返回 数据 。 返 回 代码 应 为 RESULT_OK 或 RESULT_CANCELED。RESULT_OK X 
示 Widget 设置 成 功 , Widget 宿主 会 将 Widget 实例 加 载 到 主屏 幕 上 ;如 果 返 回 的 是 
RESULT_CANCELED,Widget 宿主 则 取消 Widget 实例 的 加 载 过 程 , Widget 也 不 会 出 
现在 主屏 幕 上 。 返 回 数据 应 包含 Widget 的 ID ,并 使 用 AppWidgetManager. EXTRA _ 
APPWIDGET ID 作为 关键 字 ,示例 代码 如 下 。 


Intent resultValue=new Intent (); 

resultValue.putExtra (AppWidgetManager.EXTRA APPWIDGET ID, mAppWidgetId); 
setResult (RESULT OK, resultValue); 

finish(); 
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这 里 需要 注意 的 是 ,需要 处 理 用 户 在 未 完成 Widget 配置 前 ,通过 回 退 键 离开 
Activity 的 情况 ,方法 非常 简单 ,只 有 在 Activity 的 onCreate O 函数 开始 处 ,添加 如 下 代 
码 即 可 。 


£ public void onCreate (Bundle icicle)( 
2 setResult (RESULT CANCELED); 
3 ш. 
4 


在 未 正确 完成 Widget 配置 前 ,如 果 用 户 离开 Activity 配置 界面 ,Activity 的 返回 代 
码 则 是 RESULT_CANCELED。 

ConfigWidget 示例 中 提供 了 完整 的 代码 ,说 明 如 何在 Activity 中 选择 Widget 中 
TextView 的 字体 颜色 。ConfigWidget 示例 是 在 SimpleWidget 示例 代码 的 基础 上 进行 
的 修改 和 添加 ,部 分 代码 的 理解 可 以 参考 SimpleWidget 示例 代码 的 说 明 。ConfigWidget 
示例 的 Widget 配置 界面 如 图 10. 13 所 示 。 


ÇF 0 10:53 


ConfigWidget 


图 10.13 ConfigWidget 示例 Widget 配置 界面 


104 Widget 与 服务 


在 Widget 中 如 果 需 要 进行 频繁 更 新 ,一般 采用 Service 周期 性 更 新 Widget 的 方法 。 
Widget 元 数据 中 的 updatePeriodMillis 属性 是 无 法 进行 频繁 更 新 的 ,对 于 低 于 30 分 钟 的 
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设 定 值 ,该 属性 并 不 生效 。 

当 进 行 Widget 更 新 时 ,如 果 在 onUpdate() 函 数 中 代码 运行 时 间 超 过 5 秒 钟 , 例 如 进 
行 网 络 操作 、 复 杂 运 算 等 , 则 会 产生 应 用 程序 无 响应 (ANR,Application Not Responding) 
错误 。 使 用 Service 更 新 Widget 可 以 避免 这 种 问 
题 的 出 现 ,将 比较 耗 时 的 代码 在 Service 中 实现 ， 0.024601544761169047 
然后 直接 在 Service 更 新 Widget 的 界面 。 || — €) | 

"Fifi EA ServiceWidget 为 例 ,说 明 如 何 使 用 
Service 中 更 新 Widget。ServiceWidget 示例 的 用 图 10.14 ServiceWidget 示例 的 用 户 界面 
户 界 面 如 图 10.14 所 示 。 

ServiceWidget 示例 在 AppWidgetProvider 中 启动 Service, 当 最 后 一 个 Widget 实例 
在 主屏 幕 上 被 删除 时 停止 这 个 Service, Service 在 启动 后 会 开启 一 个 工作 线程 ,线程 每 
2 秒 钟 产生 一 个 随机 小 数 , 并 将 这 个 随机 小 数 显示 在 Widget 的 界面 上 。 

首先 给 出 Service 的 核心 代码 。 


1 @Override 

2 public void гип () { 

3 while (!Thread.interrupted())í 

4 double randomDouble- Math.random(); 

5 String msg- String.valueOf (randomDouble); 
6 WidgetProvider.updateAppWidget (this, msg); 
7 

8 try { 

9 Тһгеаа.ѕ1еер (2000); 

10 } catch (InterruptedException е) { 

30 e.printStackTrace(); 

12 } 

13 ) 

14 } 


代码 第 6 行 调用 了 WidgetProvider 中 的 静态 函数 updateAppWidget() ,进行 Widget 
界面 更 新 。 

WidgetProvider 类 继承 AppWidgetProvider, 其 中 的 公有 静态 函数 updateAppWidget() 
的 代码 如 下 。 


private static Queue< Integer» widgetIds=new LinkedList« Integer> (); 


AppWidgetManager appWidgetManager- AppWidgetManager.getInstance (context) ; 


En 

2 

3 public static void updateAppWidget (Context context, String displayMsg)(í 
4 

5 RemoteViews views- newRemoteViews (context .getPackageName () , 


R.layout.widget layout); 


D 


views.setTextViewText (R.id.label, displayMsg); 


updateAppWidget() 函 数 每 2 秒 被 执行 一 次 ,负责 所 有 Widget 实例 的 更 新 。 代 码 第 
1 行 定义 了 一 个 队列 widgetIds, 用 于 保存 所 有 Widget 实例 的 ID 值 。 代 码 第 8 行 获取 
在 代码 第 11 行 实现 Widget 的 更 新 操作 。 代 码 第 10 行 和 第 12 行 
分 别 实现 队列 数据 的 取出 和 加 入 ,主要 目的 是 为 了 遍历 队列 中 所 有 Widget 的 ID 值 。 

更 新 所 有 Widget 实例 需要 Widget 的 ID 值 , 因 此 在 WidgetProvider 类 onUpdateO 
函数 中 需 将 新 建 Widget 的 ID 值 添加 到 widgetIds 队列 中 ,并 在 onDeleted() 函 数 中 删除 


Widget 实例 的 数量 . J 


ss Widget 组 件 开 发 
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final int N-widgetIds.size(); 
for (int i-0; i«N; i++){ 
int appWidgetId- widgetIds.poll(); 
appWidgetManager.updateAppWidget (appWidgetId, views); 
widgetIds.add (appWidgetId); 


被 移 除 Widget 的 ID 值 。 
WidgetProvider 类 onUpdate() 函数 的 代码 如 下 。 


з бс Oc & ш 


ЗТ 
12 


代码 第 11 行 调用 startService O 函数 ,启动 TRandomService 服务 。 虽 然 比 较 优 雅 
的 方法 是 在 onEnableO 函数 中 调用 startService O 函数 启动 服务 ,但 在 Widget 实际 运行 
过 程 中 ,偶然 会 出 现 服务 没有 启动 , 却 不 是 首次 添加 Widget 的 情况 。 如 果 将 启动 服务 的 


@override 


public void onUpdate (Context context, AppWidgetManager 
appWidgetManager, int[] appWidgetlIds) { 
Log.d(TAG, "onUpdate"); 


for (int i-0;i« appWidgetIds.length; i++)( 
widgetIds.add(appWidgetIds[i]); 
Log.d(TAG," widgetId:"+appWidgetIds[i]+", Size:"+widgetIds 


.Size())7 


Log.d (TAG, "appWidgetIds.length:"+ appWidgetIds.length); 
context.startService (new Intent (context, TRandomService.class)); 
} 


代码 放 在 onEnableO 函数 中 ,此 时 将 无 法 启动 服务 ,Widget 也 无 法 进行 更 新 。 


在 onUpdate() 函 数 中 启动 服务 .会 导致 服务 被 多 次 启动 .如果 不 进 行 控 制 , 服 务 会 开 
启 多 个 线程 ,频繁 更 新 Widget。 因 此 ,TRandomService 类 声明 一 个 布尔 值 threadRunning. 


表示 是 否 已 经 有 工作 线程 在 运行 ,并 在 onStart() 函 数 中 进行 判断 。 
TRandomService 类 onStart O 函数 的 代码 如 下 。 


工 
2 
3 


@override 


public void onStart (Intent intent, int startId) { 
super.onStart (intent, startId); 
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4 Toast .makeText (this, "(2) 调 用 onstart():" ， Toast-LENGTH 
SHORT) . show () ; 
if (!threadRunning) { 

threadRunning= true; 

new Thread (this) .start (); 


о © мы om 


H 


WidgetProvider Ж onDeleted O 函数 负责 将 Widget 的 ID 从 widgetIds 队列 中 删除 ， 
首先 判断 ID 值 是 否 在 队列 中 ,如果 在 则 删除 。 
WidgetProvider 类 onDeleted O 函数 的 代码 如 下 。 


1 @Оуеггїде 

2 public void onDeleted (Context context, int[] appWidgetIds)( 

3 Log.d(TAG, "onDeleted"); 

4 for (int i-0; i«appWidgetIds.length;i--)( 

5 if (widgetlIds.contains (appWidgetIds [i]))( 

6 widgetIds .remove ( (Object) appWidgetIds[i]); 

7 H 

8 Log.d(TAG, " widgetIds:"+appWidgetIds[i]+", Size:"+widgetIds 
.size()); 

9 ) 

10 Log.d(TAG, "appWidgetIds.length:"- appWidgetIds.length); 

11 $ 


A 


在 最 后 一 个 Widget 被 从 主屏 幕 上 删除 后 ,没有 必要 让 服务 继续 运行 ,因此 在 
onDisabled O PK c rp JJH stopServiceO 函数 停止 服务 。 
WidgetProvider 类 onDisabled O 函数 的 代码 如 下 : 


š @ Override 

2 public void onDisabled (Context context){ 

3 Log.d(TAG, "onDisabled"); 

4 context.stopService (new Intent (context, TRandomService 
.Class)); 

5 } 


= ER 


1. 分 析 Widget 的 优势 和 不 足 。 
2. 简 述 Widget 的 设计 原则 和 注意 事项 。 
3. 尝试 开发 显示 电量 信息 或 短信 内 容 的 Widget, 
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Android NDK 开发 


Android NDK 使 Android 平台 能 够 使 用 本 地 代码 (如 C 和 C++ ) 开 发 应 用 程序 中 对 
效率 要 求 较 高 的 模块 ,并 有 利于 重用 已 有 的 C 或 C++ 代码 ,这 对 于 Android 系统 的 普及 
具有 深远 的 意义 。 通 过 本 章 的 学 习 可 以 让 读者 初步 了 解 Android МОК 的 使 用 和 开发 
Jr. 

本 章 学 习 目 标 : 

* 了解 Android МОК 的 用 途 和 不 足 ; 

。 掌握 Android NDK 编译 环境 的 安装 与 配置 方法 ; 

。 掌握 Android МОК 的 开发 步骤 ; 

。 了 解 动态 检测 CPU 类 型 的 方法 。 


11 NDK 简介 


Android NDK(Android Native Development Kit) 是 一 系列 的 开发 工具 ,允许 程序 开 
发 人 员 在 Android Ju JH Ee FF rh ik À C 或 C++ 语 言 编 写 的 本 地 代码 。 

一 般 情况 下 ,Android 程序 使 用 Java 语言 在 Android 应 用 程序 框架 下 进行 开发 , 编 
译 后 产生 的 托管 代码 在 Dalvik 虚拟 机 上 运行 。 但 在 一 些 使 用 Android 应 用 程序 框架 无 
法 满足 运行 效率 的 地 方 ,程序 开发 人 员 和 希望 能 够 使 用 本 地 代码 开发 应 用 程序 的 核心 部 
分 ,以 提高 程序 核心 模块 的 运行 效率 。 不 仅 如 此 ,程序 开发 人 员 还 希望 能 够 直接 使 用 已 
有 的 成 熟 C/C++ 源 代码 ,以 提高 Android 程序 的 开发 速度 。Android NDK 的 出 现 , 不 仅 
解决 了 核心 模块 使 用 托管 语言 开发 执行 效率 低下 的 问题 ,还 允许 直接 使 用 C/C++ 源 代 
码 , 极 大 地 提高 了 Android 应 用 程序 开发 的 灵活 性 。 

当然 ,程序 开发 人 员 不 能 只 看 到 使 用 Android МОК 开发 所 带 来 的 好 处 ,还 必须 清楚 
认识 到 什么 情况 下 才 适 合 使 用 Android МОК, Android МОК 并 不 会 自动 提升 所 有 
Android 程序 的 执行 效率 ,但 一 定 会 提高 程序 的 复杂 程度 和 调试 难度 ,因此 程序 开发 人 员 
需要 仔细 权衡 Android МОК 所 能 提升 的 运行 效率 与 增加 的 复杂 性 。 因 此 选择 使 用 
Android МОК 应 主要 出 于 以 下 两 种 目的 : 一 是 Android 应 用 程序 框架 无 法 满足 运行 效 
率 时 ;二 是 需要 使 用 大 量 已 有 C/C++ 源 代码 。 

Android NDK 提供 一 系列 的 工具 编译 文件 .文档 和 示例 代码 ,用 于 从 C/C++ 源 代 
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Е ЖЕҢЕ ЕЕ t T ЖЕЛЕ РЕНЕ A ЖП арк 文件 中 的 方法 。Android МОК 
所 包含 的 大 量 本 地 系统 头 文件 和 库 文 件 ,主要 是 用 来 支持 未 来 版 本 的 Android 系统 。 
Android МОК 所 支持 的 最 低 版 本 的 Android 系统 是 1. 5 版 本 ,如 果 使 用 本 地 Activity W 
所 需要 的 最 低 Android 系统 版 本 为 2. 3 版 本 。 

最 新 版 本 的 Android NDK 支持 ARM 指令 集 , 包 括 ARMv5TE、ARMv7-A 和 x86 。 
ARMv5TE 机 器 码 可 以 在 所 有 基于 ARM 的 Android 设备 上 使 用 ,ARMv7-A 机 器 码 则 
只 能 运行 在 具有 ARM? CPU 的 Android 设备 上 ,如 Verizon Droid 手机 和 Google Nexus 
One 手机 。ARMv7-A 与 ARMvSTE 指令 集 的 差别 主要 在 于 ,ARMv7-A 支持 硬件 ЕРО 
( 浮 点 运算 单元 )、Thumb-2 和 NEON 指令 集 。 程 序 开发 人 员 可 以 针对 不 同 目标 设备 ,在 
Android NDK 中 使 用 不 同 的 ARM 指令 集 支持 不 同 的 架构 ,也 可 以 同时 将 支持 多 个 架构 
的 指令 集 编译 到 同一 个 apk 文件 中 。 
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NDK 开发 环境 包括 Eclipse, Android NDK 和 Cygwin, Eclipse 用 了 建立 Android 
工程 和 编写 程序 代码 ;Android NDK 提供 编译 脚本 和 工具 ;Cygwin 完成 Linux 环境 下 的 
交叉 编译 ,将 C/C ++ 的 源 代 码 文件 编译 成 Android 系统 可 调用 的 共享 连接 库 文件 。 
Eclipse 就 不 再 介绍 了 ,下 面 主 要 介绍 Android NDK 和 Cygwin 的 安装 方法 。 

Android NDK 编译 环境 支持 Windows XP, Linux 和 MacOS, 本 书 仅 介 绍 Windows 
系统 的 编译 环境 配置 方法 。 首 先 ,需要 到 Google 的 Android 开发 者 网 站 下 载 Android 
NDK 的 安装 包 , 下 载 地 址 是 http://developer. android. com/sdk/ndk/index. html, 下 载 
页 面 如 图 11. 1 所 示 。 笔 者 下 载 的 Android МОК 是 Windows 的 10e 版 本 ,下 载 的 文件 为 
android-ndk-rl0e-windows-x86_64. exe。 双 击 下 载 的 exe 文件 即 可 将 Android МОК 解 
压 到 当前 文件 夹 中 ,笔者 将 Android МОК 解压 到 D:\ 目 录 中 ,Android МОК 的 最 终 路 径 
为 D:\android-ndk-r6b。 


NDK Downloads 


Select, from the table below, the NDK package for your development platform. For information about the changes in 


the newest version of the МОК, see Release Notes. For Information about earlier revisions, see МОК Revision History. 


Downloading 


Platform Package Size (Bytes) | MD5 Checksum 
Windows 32-bit android-ndk-r10e-windows-x86 exe 396563176 1a82445baaf62aec3a46386able5772c 


Windows 64-bit android-ndk-r10e-windows- 419616132 — 8412bb4991a95e08fda50b5a44d95df7 
x86. 64 exe 


MacOSX64-bit | android-ndkeriOe-darwin-x86 64.bin 388937326 2cb8893a5701603519d3827e04c50e81 
Linux 32-bit android-ndk-ri0e-linuxx86.bin 394281908 c3edd3273029da1cbd2f620482496978 
(x86) 
Linux 64-bit android-ndk-r10e-inux-x86_64 bin 401522849 ^ 19af543b068bdb7127787c2bc69aba7f 
(x86) 


Æ 11.1 Android NDK 下 载 页 面 


zO: Android NDK 开 发 
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第 二 步 是 下 载 并 安装 Cygwin。 目 前 ,Android МОК 还 不 支持 在 Windows 系统 下 直 
接 进行 交叉 编译 ,因此 需要 在 Windows 系统 中 安装 Linux 的 模拟 器 环境 Cygwin, 完 成 


С/С++ 代码 的 交叉 编译 工作 。Android МОК 要 求 Cygwin 的 版 本 高 于 1.7. 


因此 最 好 安 


装 较 新 版 本 的 Cygwin。Cygwin 的 最 新 版 本 可 以 到 官方 网 站 http://www. cygwin. com 
FR. 在 Cygwin 的 安装 过 程 中 ,需要 将 Devel 下 的 gcc 和 make 的 相关 选项 选 上 , 如 


图 11.2 所 示 ,否则 Cygwin 将 无 法 编译 C 


/C++ 源 代 码 文件 。 


Bin? Sre? Sire Package 


1,308k fossil: DVCS with 
13,803k gcccada: GNU Comp 
14,758К gec-core: GNU Сок 
5, 943k gcc-fortran: GNU 1 
T,98Tk фос #+: GNU Соар 
4,601k gcc-obje: GNU Cem: 
4,826k gce-objett: GNU C 
&#5кєссс\өёйлгазөеы- 7 


11.2 


CEEE] 


Cygwin 安装 选项 


113 NDK 文 档 和 示例 


在 介绍 МОК 开发 前 ,首先 熟悉 一 下 Android МОК 为 程序 开发 人 员 提 供 的 资料 和 示 
例 。Android МОК 的 目录 中 包含 7 个 子 目录 和 7 个 文件 ,结构 如 图 11. 3 所 示 。 


(+)build 
(+)docs 
(+)platforms 
(+)prebuilt 
(+)samples 
(*)sources 
(tests 
(+)toolchains 


(—)find-win-host.cmd 
(—)GNUmakefile 
(—)ndk-build 
(—)ndk-build.cmd 
(—ndk-depends.exe 
(—)ndk-gdb 
(—)ndk-gdb.py 
(—)ndk-gdb-py 
(—ndk-gdb-py.cmd 
(—ndk-statck.exe 
(—ndk-which 
(—)README.txt 
(—)RELEASE.txt 
(—)remove-windows-symlink.sh 


11.3 Android NDK 的 目录 结构 
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表 11.1 
x 件 名 


其 中 ,build 目录 保存 了 编译 脚本 和 配置 文件 。docs 目录 是 帮助 文档 目录 ,帮助 文档 的 名 
称 和 用 途 参考 表 11.1. platforms 是 保存 了 编译 过 程 中 可 能 用 到 的 头 文件 和 库 文件 ,并 
根据 Android 版 本 和 CPU 类 型 进行 分 类 。sources 目录 中 保留 了 程序 中 可 能 用 到 的 
C/C++ 源 代码 文件 ,CPU 类 型 检查 和 本 地 Activity 的 C/C ++ 源 代 码 文件 就 在 这 个 目录 
H, tests 是 测试 代码 目录 ,toolchains 是 交叉 编译 工具 目录 。 


docs 目录 中 的 帮助 文件 说 明 


说 M 


OVERVIEW. html 


Android МОК 的 概括 性 说 明 , 包 括 МОК 的 目标 .适用 范 
围 \ 开 发 步骤 和 NDK 关键 配置 文件 的 简要 说 明 等 


INSTALL. html 


NDK 的 安装 与 配置 说 明文 档 


DEVELOPMENT. html 


说 明 如 何 对 NDK 进行 修改 ,以 及 如 何 发 布 新 的 实验 性 
NDK 包 


HOWTO. html 


关于 NDK 通用 性 问题 的 说 明 


ANDROID-MK. html 


说 明 构建 Android. mk 文件 的 语法 格式 。Android. mk 定 
义 了 模块 的 编译 信息 ,包括 模块 (module) 名 称 、 与 C/C++ 
源 代码 文件 的 对 应 关系 


APPLICATION-MK. html 


说 明 构 建 Application. mk 文件 的 语法 格式 。Application. 
mk 定义 应 用 程序 的 编译 信息 ,包括 CPU 体系 类 型 ,模块 
列表 ,编译 器 的 参数 等 


CPU-ARCH-ABIS. html 


处 理 器 ABIS( 应 用 程序 二 进 制 接口 ) 说 明文 档 


CPU-ARM-NEON. html 


ARM 处 理 器 NEON 扩展 指令 集 说 明文 档 


CPU-FEATURES. html 


处 理 器 类 型 和 指令 集 特征 的 检查 说 明文 档 


IMPORT-MODULE. html 


说 明 如 何在 Android. mk 中 引用 其 他 模块 ,以 及 建立 引用 
模块 的 方法 


NDK-BUILD. html 


如 何 使 用 ndk-build 脚本 进行 编译 


NDK-GDB. html 


如 何 使 用 ndk-gdb 脚本 进行 本 地 调试 


PREBUILTS. html 


如 何 制作 预 编译 库 文件 


STABLE-APIS. html 


支持 的 稳定 的 API XK 


STANDALONE-TOOLCHAIN. html 


如 何 将 NDK 提供 的 交叉 编译 工具 作为 独立 的 编译 器 使 用 


system/libc/OVERVIEW. html Bionic C 库 的 简介 

system/libc/SYSV-IPC. html 介绍 МОК 不 支持 system v 进程 间 通 信 的 原因 
system/libc/CHANGES. html 不 同 版 本 下 Bionic 的 区 别 

CHANGES. html 不 同 版 本 NDK 的 区 别 

SYSTEM-ISSUES, html NDK 开发 所 需要 注意 的 问题 

LICENSES. html NDK 的 使 用 许可 


GNUmakefile 编译 配置 文件 。 


ndk-build 是 交叉 编译 的 快捷 脚本 。ndkrgdb 用 于 
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Debug 调试 的 脚本 。README. txt 和 RELEASE. txt 分 别 是 Android МОК 的 说 明文 档 
和 版 本 信息 。 

samples 目录 中 是 为 程序 开发 人 员 提 供 的 Android NDK 开发 示例 ,示例 的 详细 信息 
可 参考 表 11. 2。 


表 11.2 samples 目录 中 的 NDK 开发 示例 


示 例 说 明 
hello-ini 非常 简单 的 NDK 示例 ,使 用 共享 库 调用 本 地 函数 获取 一 个 字符 串 , 然 后 显示 在 用 
ello-jni 
户 界 面 上 
稍微 复杂 一 些 的 示例 ,程序 中 有 两 个 库 ,一 个 静态 库 和 一 个 动态 库 。 静 态 库 实 现 了 
two-libs 简单 的 加 法 运算 ,动态 库 则 调用 了 静态 库 中 的 加 法 函数 ,并 进行 了 重新 封装 。 应 用 


程序 则 动态 加 载 这 个 动态 共享 库 , 然 后 调用 重新 封装 后 的 加 法 函数 
当 使 用 GLSurfaceView 对 象 管理 Activity 的 生命 周期 时 ,使 用 本 地 的 OpenGL ES 
APIs 泻 染 3D [ff 


hello-gl2 使 用 OpenGL ES 2. 0 的 定点 和 片段 着 色 器 泻 染 三 角形 

演示 如 何在 运行 时 通过 使 用 cpufeatures 库 检 测 CPU 的 类 型 ,如 果 CPU 支持 
NEON 指令 集 , 则 尝试 使 用 NEON 指令 集 

bitmap-plasma 说 明 如 何 通过 本 地 代码 访问 Android 的 Bitmap 像素 缓冲 

native-activity 说 明 如 何 使 用 静态 库 native-app-glue 建立 本 地 的 Activity 


native-plasma 通过 本 地 Activity 实现 的 bitmap-plasma 示例 


san-angeles 


hello-neon 


Android NDK 中 的 hello-jni 示例 是 最 简单 的 入 门 实例 ,程序 开发 人 员 可 以 通过 这 个 
示例 了 解 NDK 开发 的 基本 方法 。two-libs 示例 侧重 说 明 如 何在 动态 库 中 使 用 静态 库 。 
hello-neon 示例 重点 说 明 如 何 为 不 同 CPU 编译 具有 针对 性 的 优化 代码 ,其 余 的 示例 主要 
介绍 与 图 像 相关 的 本 地 开发 。 
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在 进行 NDK 开发 时 ,一 般 先 要 建立 Android 工程 ,在 Android 工程 中 创建 存放 C/C++ 
代码 的 jni 目录 。 然 后 在 Cygwin 环境 中 编译 C/C ++ 代码, NDK 的 编译 脚本 会 在 
Android 工程 中 自动 建立 libs 目录 ,将 编译 后 形成 的 共享 库 文件 保存 在 libs 目录 中 。 最 
后 ,在 编译 Android 工程 时 ,libs 中 的 共享 库 文件 会 被 打包 到 apk 文件 中 ,保证 Android 
程序 可 以 正常 运行 。 

下 面 的 内 容 以 AndroidNdkDemo 为 例 来 说 明 如 何 进 行 Android NDK 开发 。 
AndroidNdkDemo 是 一 个 加 法 运算 的 示例 ,程序 会 随机 生产 两 个 整数 ,然后 调用 C 语言 
开发 的 共享 库 对 这 两 个 整数 进行 加 法 运算 ,最 后 将 运算 结果 显示 在 用 户 界面 上 。 
AndroidNdkDemo 示例 的 界面 如 图 11.4 所 示 。 

进行 Android МОК 开发 一 般 要 经 过 如 下 的 步骤 : 

(1) 建立 Android Т.Ж; 
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° (h$ 07:51 


AndroidNdkDemo 


加 法 运算 


图 11.4 AndroidNdkDemo 示例 界面 
(2) 建立 Android. mk 文件 ; 
(3) 建立 C 源 代 码 文 件 ; 
(4) 编译 共享 库 模 块 ， 


(5) 运行 Android 程序 。 


1. 建立 Android 工程 


首先 在 Eclipse 中 建立 Android 工程 时 ,工程 名 称 为 AndroidNdkDemo, 并 在 工程 中 
建立 一 个 新 目录 jni, 用 来 保存 C/C++ 代码 文件 。jni 的 子 目录 结构 不 必 遵 循 Java 代码 的 目 
录 结 构 , 如 com. < mycompany >. < myproject > , TEE = 
可 以 将 所 有 的 C/C ++ 代码 文件 放置 在 jni 目录 日 乞 | o> v 
下 ,也 可 以 创建 子 目 录 保 存 , 并 不 影响 最 后 的 编 . нр 
译 结 果 。AndroidNdkDemo 工程 的 目录 结构 如 4 (9 src 
图 11.5 所 示 。 rire e 

这 个 示例 中 采用 自 顶 向 下 的 方式 进行 开发 ， сом 
首先 编写 Anroid 程序 的 用 户 界面 ,然后 开发 C/ Б bin 
C 的 共享 库 。 为 了 调试 方便 , 先 在 Java 代码 Ба. 

中 编写 一 个 功能 相近 函数 ,在 用 户 界面 调试 中 使 D нын 
用 , 当 完 成 C/C++ 的 共享 库 开 发 后 ,再 用 共享 库 Ë pica Й 


中 的 函数 替代 这 个 Java 代码 函数 。 

在 建立 AndroidNdkDemo 工程 后 ,修改 
main. xml 文件 , 添加 一 个 id 为 display 的 
TextView 和 一 个 id 为 add_btn 的 Button 按钮 。 程 序 中 的 产生 随机 数 和 调用 的 代码 在 
AndroidNdkDemoActivity. java 文件 中 ,下 面 是 AndroidNdkDemoActivity. java 文件 的 
核心 代码 。 


图 11.5 AndroidNdkDemo 工程 目录 结构 


public class AndroidNdkDemoAcitivity extends Activity { 


@override 


public void onCreate (Bundle savedInstanceState) { 


setContentView (R.layout .main); 
final TextView displayLable- (TextView)findViewById (R.id.display); 


1 

з 

4 super .onCreate (savedInstanceState); 

5 

6 

了 Button btn= (Button)findViewById (R.id.add btn); 
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8 btn.setOnClickListener (new View.OnClickListener () ( 
9 @ Override 

10 public void onClick (View у) { 

31. double randomDouble- Math. random () ; 

12 long x-Math.round (randomDouble * 100); 
13 randomDouble- Math.random(); 

14 long y-Math.round (randomDouble * 100); 
15 

16 //System. loadLibrary ("add- module"); 
17 long z-add(x, y); 

18 String msg=x+ "+ "+y+ "= "+2; 

19 displayLable.setText (msg) ; 

20 } 

21 D; 

22 } 

23 //public native long add(long х, long у); 

24 

25 public long add(long x, long у) { 

26 return х+у; 

27 } 

28 } 


在 代码 第 17 行 本 应 该 调用 共享 库 的 add() 函 数 ,但 为 了 便于 开发 和 调试 ,在 代码 第 
25 行 到 第 27 行 , 使 用 Java 代码 开发 了 一 个 功能 相同 的 addO 〇 函数 ,这 样 即使 在 没有 完成 
C/C++ 共享 库 的 开发 前 ,也 可 以 对 Android 工程 进行 界面 部 分 的 调试 。 

第 16 行 和 第 23 行 注释 掉 的 代码 ,就 是 在 C/C++ 的 共享 库 开发 完毕 后 需要 使 用 的 代 
码 , 其 中 第 16 行 是 动态 加 载 共 享 库 的 代码 ,加 载 的 共享 库 名 称 为 add-module。 动 态 加 载 
是 在 调用 共享 库 中 的 函数 前 ,在 程序 代码 中 指明 需要 加 载 的 模块 名 称 。 除 了 动态 加 载 以 
外 ,程序 开发 人 员 还 可 以 使 用 静态 加 载 的 方式 ,在 类 加 载 时 加 载 共享 库 ,代码 如 下 : 


static( 
System. loadLibrary ("add- module"); 
) 


第 23 行 用 来 声明 共享 库 中 的 add() 函 数 ,必须 使 用 与 C/C++ 代码 文件 同名 的 函数 。 
在 共享 库 开 发 完毕 后 ,取消 第 16 行 和 第 23 行 代码 的 注释 ,并 注释 掉 第 25 行 到 第 27 行 代 
码 , 这 样 程序 就 可 以 正常 调用 共享 库 内 的 函数 进行 加 法 运算 。 


2. 建立 Android. mk 文件 


Android. mk Æ jni 根 目 录 下 必须 存在 的 描述 C/C++ 代码 文件 模块 信息 的 文件 ,将 
代码 模块 的 编译 信息 传递 给 NDK 编译 系统 ,是 NDK 编译 系统 编译 脚本 的 一 部 分 。 在 编 
写 C/C++ 源 代码 文件 前 ,首先 在 jni 目录 中 建立 Android. mk 文件 。 

一 般 情 况 下 ,NDK 编译 系统 会 搜寻 所 project>/jini 目录 中 的 Android. mk 文件 ,其 
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H<project >Æ Android 的 工程 目录 。 但 如 果 程 序 开 发 人 员 将 Android. mk 文件 放置 在 
下 一 级 目录 中 , 则 需要 在 上 一 级 目录 中 的 Android. mk 文件 中 告知 МОК 编译 系统 遍历 
所 有 子 目 录 中 的 Android. mk 文件 ,在 jni 目录 下 Android. mk 文件 添加 的 代码 如 下 。 


include $ (call all- subdir-makefiles) 


下 面 来 分 析 AndroidNdkDemo 示例 jni 目录 下 的 Android. mk X fF, Android. mk 
文件 的 代码 如 下 。 


LOCAL PATH :=$ (call my- dir) 


include $ (CLEAR VARS) 


1 

а 

3 

4 

5 LOCAL MODULE :- add- module 

6 LOCAL SRC FILES :-add- module.c 
7 
8 


include $ (BUILD SHARED LIBRARY) 


每 个 Android. mk 文件 都 必须 以 第 1 行 代码 开始 ,变量 LOCAL. PATH 用 来 定义 需 
要 编译 的 C/C++ 源 代 码 的 位 置 ,my-dir 由 МОК 编译 系统 提供 ,表示 当前 目录 的 位 置 。 
在 AndroidNdkDemo 示例 中 ,my-dir 表示 Android. mk 所 在 的 jni 目录 。 

代码 第 3 行 的 include $ (CLEAR_VARS) 表 示 清 空 所 有 以 LOCAL 开始 的 变量 , 例 
如 LOCAL_MODULE、LOCAL_SRC_FILES、LOCAL_STATIC_LIBRARIES 等 ,但 第 
1 行 定 义 的 LOCAL. PATH 不 在 清空 的 范围 内 。 因 为 所 有 的 编译 脚本 都 将 在 同一 个 
GNU Make 的 执行 环境 中 ,而 且 所 有 变量 都 是 全 局 变量 ,因此 在 每 次 使 用 前 必须 清空 所 
有 以 前 用 过 的 变量 。 

第 5 行 代 码 变量 LOCAL MODULE 用 来 声明 模块 名 称 ,模块 名 称 必须 唯一 ,而 且 中 
间 不 能 存在 空格 。NDK 编译 系统 将 会 在 模块 名 称 前 自动 添加 lib 前 级 ,然后 生成 so X 
件 。 这 里 的 模块 名 称 为 add-module, 生 成 的 共享 库 文 件 名 为 libadd-module. so。 但 需要 
注意 的 是 ,如 果 程 序 开发 人 员 使 用 具有 lib 前 级 的 模块 名 称 , NDK 编译 系统 将 不 再 添加 
前 级 ,例如 模块 名 称 为 libsub, 生 成 的 共享 库 文件 名 为 libsub. so, 

第 6 行 代码 中 的 变量 LOCAL_SRC_FILES 表示 编译 模块 所 需要 使 用 的 C/C++ X: 
件 列表 ,但 不 需要 给 出 头 文件 的 列表 ,因为 NDK 编译 系统 会 自动 计算 依赖 关系 。add- 
module 模块 仅 需 要 一 个 C 文件, 文件 名 为 add-module. c。 默 认 情 况 下 ,结尾 名 为 .c 的 文 
件 是 C 语言 源 文件 ,结尾 名 为 . epp 的 文件 是 C++ 语言 源 文件 。 

第 8 行 代码 include $ (BUILD_SHARED_LIBRARY) 表 示 Android NDK 编译 系统 
需要 构建 共享 库 , 如果 变 量 BUILD SHARED. LIBRARY 更 改 为 BUILD_STATIC __ 
LIBRARY, 则 表示 需要 МОК 编译 系统 构建 静态 库 。 共 享 库 和 静态 库 文 件 有 着 不 同 的 用 
i& ,共享 库 可 以 被 Android 工程 中 的 Java 代码 调用 ,并 打包 到 apk 文件 中 。 静 态 库 不 能 
被 Java 代码 调用 ,也 不 能 打包 到 apk 文件 中 ,只 能 在 生成 共享 库 的 过 程 中 被 共享 库 中 的 
С/С++ 代码 所 调用 。 
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3. 建立 C 源 代码 文件 


根据 Android. mk 文件 的 声明 ,add-module 模块 仅 包 含 一 个 C 源 代码 文件 add- 
module. с. Ji Z YE jni 目录 中 建立 add-module.c 文 件 ,在 该 文件 中 实现 整数 加 法 运算 功 
能 ,全 部 代码 如 下 : 


1 #include « jni.h» 

2 

3  jlong Java edu hrbeu AndroidNdkDemo AndroidNdkDemoActivity add 
(JNIEnv*  env,jobject this, jlong x, jlong y) 

4 4d 

5 return x+ y; 


6 ) 


代码 第 1 行 引入 的 是 JNICJava Native Interface) 的 头 文件 。 第 3 行 代 码 是 函数 名 
称 ,jlong 表示 Java 长 型 整数 ,Java_edu_hrbeu_AndroidNdkDemo_AndroidNdkDemo _ 
add 的 构成 为 Java_ 志 包 名 称 二 _ 所 类 二 _ 志 函数 二 ,其 中 所 函数 二 的 名 称 和 参数 要 与 
Android 工程 中 AndroidNdkDemoActivity. java 文件 定义 的 函数 一 致 。 
ронан java 文件 定义 的 函数 为 public native long add(long х, long 
。 第 5 行 代码 用 来 返回 加 法 运算 结果 。 


4. 编译 共享 库 模 块 


到 目前 为 止 ,编译 前 的 准备 工作 基本 就 绪 , 程 序 开发 人 员 可 以 编译 C 语言 开发 的 共 
享 库 模块 了 。 首 先 启 动 Cygwin ,然后 切换 到 Androd NDK 的 主 目录 下 


cd /cygdrive/d/android- ndk- r10e 
键入 如 下 的 编译 命令 : 
export NDK- /cygdrive/d/android- ndk- zl0e 


export Ж Linux 下 的 变量 设置 命令 ,设置 一 个 名 为 МОК 的 变量 (变量 名 称 可 以 更 
换 ) ,用 来 保存 Android МОК 的 主 目录 位 置 。 笔 者 的 NDK 保存 在 D:Nandroid-ndk-r10e, 
因此 在 Cygwin 中 的 目录 则 是 /cygdrive/d/android-ndk-rl0e。 设 置 NDK 变量 的 目的 是 
简化 后 面 编译 过 程 中 的 命令 输入 操作 。 程 序 开 发 人 员 可 以 使 用 Linux 的 echo 命令 查看 
NDK 变量 的 值 ,如 图 11.6 所 示 。 

然后 使 用 cd 命令 和 cd.. 命令 切换 到 Android 的 工程 目录 下 ,使 用 Android NDK Н 
录 中 提供 的 脚本 文件 ndk-build 编译 C 代码 模块 。ndk-build 脚本 是 Android NDK 为 简 
化 编译 过 程 而 在 v4 版 本 中 推出 的 ,该 脚本 会 自动 探索 Android 工程 目录 中 的 文件 ,以 确 
定 哪些 文件 需要 编译 ,以 及 如 何 进行 编译 。 程 序 开发 人 员 只 需要 在 Android 的 工程 目录 
下 输入 如 下 命令 


$ NDK/ndk- build 
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(tm /modrwdnrdcidndcaoe ES 


ynlink.sh | 


В 11.6 NDK 变量 设置 与 查看 


编译 成 功 的 提示 如 图 11.7 所 示 。 提 示 信 息 说 明 将 add-module. c 源 文件 编译 成 add 
module 模块 ,产生 的 libadd-module. so 文件 保存 在 二 project libs/armeabi 目录 中 。 


画 /cygdrive/d/AndroidWorkplace/AndroidNdkDemo LO 


11.7 编译 成 功 提 示 


5. 运行 Android 程序 


在 运行 AndroidNdkDemo 示例 程序 前 ,务必 将 AndroidNdkDemoActivity. java 文件 
中 第 16 行 和 第 23 行 的 注释 取消 ,并 注释 掉 第 25—27 行 代码 。 

代码 修改 后 ,AndroidNdkDemo 示例 将 调用 libadd-module. so 文件 中 的 add() PR Zi. 
完成 加 法 运算 ,并 将 结果 显示 在 用 户 界面 上 。 
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本 节 将 以 Android МОК 中 提供 的 示例 代码 hello-neon 为 例 , 说 明 如 何在 代码 中 动态 
检测 CPU 类 型 ,并 根据 CPU 类 型 对 C 代码 中 的 算法 进行 优化 。 

hello-neon 示例 分 别 使 用 C 语言 和 Neon 指令 集 实 现 了 FIR( 有 限 长 脉冲 响应 ) 滤 波 
器 算法 ,并 在 程序 中 分 别 运行 C 语言 和 NEON 指令 集 版 本 的 FIR 算法 (前 提 条 件 是 手机 


CPU 支持 Neon 指令 集 ) ,将 两 个 版 本 算法 的 运算 时 间 显 示 在 用 户 界面 上 ,如 图 11.8 所 示 。 


下 面 来 介绍 两 个 概念 FIR 滤波 器 和 NEON, FIR 滤波 器 是 数字 滤波 器 的 一 种 ,是 对 
数字 信和 号 进行 滤波 处 理 以 得 到 期 望 的 响应 特性 的 离散 时 间 系 统 。FIR 滤波 器 具体 算法 


HelloNeon 


图 11.8 hello-neon 示例 界面 


内 容 已 超出 本 书 的 讨论 范围 ,具体 内 容 可 以 查阅 相关 资料 。NEON 是 通用 的 单 指令 多 数 
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据 引擎 ,通过 一 次 处 理 多 个 数据 ,可 加 速 多 媒体 和 信和 号 的 处 理 算法 ,但 需要 CPU 的 硬件 


支持 。 


hello-neon 示例 在 二 Android NDK 二 /samples/hello-neon 目录 中 。 在 Eclipse 中 , 通 


过 File Import-General— Existing Projects into Workspace, 将 hello-neon 示例 代码 导 
入 Eclipse, 如 图 11.9 所 示 。 在 Select root directory 中 选择 hello-neon 所 在 的 目录 ,并 将 
复 选 框 Copy projects into workspace 选 上 ,这 样 不 仅 能 够 将 hello-neon 工程 导入 Eclipse 


中 ,还 同时 将 hello-neon 示例 的 所 有 文件 都 复制 到 用 户 的 工作 空间 中 s 


r 


° 


[ 
Import projects 


Select a directory to search for existing Android projects 


Root Directory: DAandroid-ndk-r10e\samples\hello-neon 
Projects: 

Project to Import 
[Z] DAandroid-ndk-r10e\samples... HelloNeon 


New Project Name 


Working sets 
回 Add project to working sets 


@ [eme мее >) [ 


Finish 


Cancel 


11.9 导入 hello-neon 示例 
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按照 11.4 节 AndroidNdkDemo 示例 提供 的 方 
法 进行 编译 ,编译 后 在 Eclipse 中 hello-neon 工程 
上 选择 Refresh( 刷 新 ) 按 钮 ,新 生成 的 目录 和 文件 
便 可 显示 在 Eclipse 的 Package Explorer "P. 如 
图 11. 10 所 示 。 

与 AndroidNdkDemo 示例 对 比 ,hello-neon 示 
例 在 jni 目录 中 多 了 一 个 Application. mk 的 文件 ， 
而 且 在 libs 目录 中 增加 了 一 个 新 目录 armeabi- 
vla, 5j armeabi 目录 具有 同名 的 文件 libhelloneon 
.so。 后 面 的 内 容 会 详细 介绍 这 些 新 目录 和 新 文件 
的 作用 和 使 用 方法 。 


1. HelloNeon. java 文件 


从 Android 工程 中 的 HelloNeon. java 文件 开 
始 说 明 , 此 文件 主要 实现 了 一 个 用 于 界面 的 
Activity 类 ,并 通过 调用 共享 库 helloneon 中 的 
stringFromJ NIC 函数 ,将 获取 的 字符 串 显示 在 用 
户 界面 上 。HelloNeon. java 文件 的 代码 如 下 : 


package com.example.neon; 
import android.app.Activity; 


import android.os.Bundle; 


public class HelloNeon extends Activity 


1 
2 
3 
4 
5 import android.widget.TextView; 
6 
kd 
8 ( 

9 


@ Override 


10 public void onCreate (Bundle savedInstanceState) 
п { 

12 super.onCreate (savedInstanceState); 
a TextView tv-new TextView (this); 

14 tv.setText (stringFromJNI ()); 

15 setContentView (tv) ; 

16 } 

17 

18 public native String  stringFromJNI (); 
19 

20 static( 

21 System.loadLibrary ("helloneon"); 

22 } 


Li 


" 


Package Explorer 22 
Sle v 
|2 HelloNeon| 
4 (9 src 


4 88 com.example.neon 
> [0 HelleNeonjava 
b @8 gen [Generated Java Files] 
b BÀ Android 5.0.1 
E assets 
b B bin 
4 @ jni 
[5 Android.mk 
[Š Application.mk 
[8 helloneon-intrinsics.c 
[8 helloneon-intrinsics.h 
[8 helloneon.c 
4 B libs 
4 @ armeabi 
Ë libhelloneor.so 
4 © armeabi-v7a 
Ë libhelloneon.so 
b Es res 
E AndroidManifestxml 
В build.properties 
В project.properties 


.10  hello-neon 示例 的 目录 结构 


cL 
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代码 第 14 行 调用 本 地 方法 stringFromJ NIO ,返回 的 字符 串 信 息 供 TextView 显示 。 
代码 第 18 行 用 来 声明 本 地 方法 ,其 中 native 是 声明 本 地 方法 的 标识 。 代 码 第 20 至 22 
行 , 使 用 静态 方式 加 载 共 享 库 helloneon ,根据 共享 库 的 命名 规则 可 知 ,共享 库 的 文件 名 称 
应 为 libhelloneon. so。 


2. Application. mk 文件 


Application. mk 定义 了 应 用 程序 编译 的 基本 信息 ,是 Android NDK 编译 系统 中 的 
非 必 备 文件 ,如 果 出 现 , 则 应 保存 在 二 Android NDK /jni 目录 中 。hello-neon 示例 的 
Application. mk 文件 的 代码 如 下 : 


1 #Build both ARMv5TE and ARMv7- A machine code. 

2 APP ABI :-armeabi armeabi- v7a 

Application. mk 文件 中 有 效 代 码 只 有 一 行 。 第 1 行 是 注释 信息 ,说明 Android NDK 
编译 系统 将 同时 为 ARMv5TE 和 ARMv7-A 指令 集 的 CPU 编译 两 种 机 器 码 。 第 2 行 则 
是 有 效 代码 ,变量 APP. ABI 是 用 来 指定 所 支持 的 ABI, 代 码 的 含义 是 编译 支持 armeabi 
和 armeabi-v7a 的 两 个 共享 库 。 

ABI 是 二 进 制 代 码 接 口 (Application Binary Interface) ,是 与 CPU 指令 集 密切 相关 
的 接口 规范 。Android МОК 编译 系统 支持 3 种 ABI: armeabi;armeabi-v7a 和 x86 ,分别 
对 应 ARMv5TE、ARMv7-A 和 X86 指令 集 的 CPU。 在 不 指定 ABI 的 情况 下 ,Android 
NDK 默认 的 ABI 为 armeabi。 

在 本 示例 中 同时 指定 了 两 个 ABI, 编译 时 会 生成 两 个 同名 的 共享 库 文件 ,然后 分 别 
复制 到 Android 工程 的 libsN < АВІ H 3 rh. — ABI Æ ABI 小写 字母 为 名 称 的 子 目 
录 。 例 如 ,在 本 例 中 ,libs 目录 下 生成 两 个 子 目录 ,分 别 是 armeabi 和 armeabi-v7a, 这 两 
个 目录 中 都 有 libhelloneon. so 文件。 在 Android 工程 打包 时 ,这 两 个 库 文 件 都 会 被 打包 
在 арк 文件 中 ,这 种 支持 多 个 CPU 体系 结构 的 apk 文件 称 为 “ 胖 二 进 制 包 ”(fat binary). 
арк 文件 在 Android 系统 进行 安装 时 ,系统 的 包 管 理 器 (package manager) 会 根据 CPU 
类 型 选择 合适 的 动态 库 ,而 不 会 将 不 支持 的 动态 库 安装 到 Android 系统 中 。 

为 验证 上 面 的 描述 ,用户 可 以 将 编译 成 功 的 二 project 二 \bin\HelloNeon. apk 文件 解 
压 , 在 libs 目录 中 可 以 找 在 armeabi 和 armeabi-v7a 目录 的 两 个 libhelloneon. so 文件 。 
然后 使 用 Eclipse 的 DDMS 模式 ,在 File Explorer 中 浏览 已 安装 的 程序 的 数据 信息 ,本 
示例 安装 后 的 共享 库 文件 保存 在 \data\data\com. example. neon\lib, 在 这 个 目录 中 只 能 
找到 一 个 libhelloneon. so 文件 ,说 明 包 管理 器 已 经 根据 CPU 类 型 对 动态 库 进行 了 选择 。 

Application. mk 的 变量 说 明 可 以 参考 表 11. 3。 


3. Android. mk 文件 


hello-neon 示例 的 Android. mk 文件 ,不 仅 声 明了 需要 编译 的 模块 信息 ,还 引用 了 
Android NDK 的 一 个 静态 库 cpufeatures。 
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з в 


Ж 11.3 Application. mk 的 变量 说 明 


强制 使 用 说 RH 


APP PROJECT PATH 


f Android 工程 所 在 的 目录 


APP MODULES 


需 编 译 的 模块 列表 。 如 不 指定 , NDK 将 编译 所 有 在 
= Android. mk 中 声明 的 模块 ;如 果 指 定 , 则 应 是 以 空格 作为 分 
隔 符 的 模块 列表 ,NDK 会 自动 计算 模块 之 间 的 依赖 关系 


APP_OPTIM 


指定 debug 或 release 模式 。release 是 默认 设置 ,产生 高 度 优 
化 的 二 进 制 代码 ,debug 则 会 产生 非 优化 代码 ,更 加 易于 调试 


APP CFLAGS 


否 编译 C/C++ 代码 时 的 编译 器 参数 


APP_CXXFLAGS 


f 与 APP CPPFLAGS 相同 ,后 续 版 本 将 取消 此 变量 


APP_CPPFLAGS 


f 编译 C++ 代码 时 的 编译 器 参数 


APP_BUILD_SCRIPT 


指定 Android. mk 脚本 所 在 的 目录 ,默认 在 二 Anroid NDK> 
Nini\Android. mk 


APP ABI 


指定 ABI 类 型 


APP_STL 


指定 STL 类 型 


cpufeatures 是 用 来 检测 CPU 类 型 的 模块 ,其 源 代 码 在 二 Android NDK>NsourcesN 
androidVcpufeatures 目录 中 , 共 3 个 文件 Android. mk,cpu-features. h 和 cpu-features. c. 
分 别 是 模块 声明 文件 、 头 文件 和 源 代码 文件 。 分 析 cpufeatures 中 Android. mk 代码 可 以 
发 现 ,这 些 文件 为 Android МОК 编译 系统 提供 了 静态 库 cpufeatures, 供 其 他 模块 在 检测 
CPU 类 型 时 调用 。cpufeatures 中 Android. mk 文件 的 代码 如 下 : 


з o ольш мыо PP 


include $ (CLEAR VARS) 

LOCAL MODULE :=cpufeatures 
LOCAL SRC FILES :=cpu-features.c 

LOCAL EXPORT C INCLUDES :=$ (LOCAL PATH) 
include $ (BUILD STATIC LIBRARY) 


LOCAL PATH :=$ (call my- dir) 


cpu-features. h 头 文件 声明 了 android. getCpuFamily O PR Zt. Iñ FL IK B. C 语音 实现 
则 在 cpu-features. c 文件 中 。cpu-features.h 的 函数 声明 代码 如 下 : 


extern AndroidCpuFamily “Android getCpuFamily (void); 


在 了 解 cpufeatures 模块 的 用 途 和 函数 后 ,下 一 步 对 hello-neon 示例 的 Android. mk 
文件 进行 分 析 。hello-neon 示例 Android. mk 文件 的 代码 如 下 : 


а b ш мын 


LOCAL РАТН :=$ (са11 my-dir) 
include $ (CLEAR VARS) 


LOCAL MODULE :=helloneon 
LOCAL SRC FILES :-helloneon.c 


zO: Android NDK 开 发 287 


ifeq($ (TARGET ARCH ABI),armeabi- v7a) 
LOCAL CFLAGS :—- DHAVE NEON- 1 
LOCAL SRC FILES* -helloneon- intrinsics.c.neon 


10 endif 


12 LOCAL STATIC LIBRARIES :-cpufeatures 
13 LOCAL LDLIBS :=- 1109 
14 include $ (BUILD SHARED LIBRARY) 


16 $ (call import- module, cpufeatures) 


代码 1—5 行 的 内 容 已 经 在 上 一 个 示例 中 进行 了 详细 的 介绍 ,这 里 不 再 重复 说 明了 。 
代码 第 7 行 的 ifeq 用 来 判断 变量 TARGET. ARCH _ ABI 是 否 为 armeabi-v7a。 
TARGET_ARCH_ABI 变量 由 Android NDK 提供 ,表示 目标 CPU 和 ABI 类 型 ,该 变量 
仅 支 持 两 个 值 ， armeabi 和 armeabi-v7a. 分 别 代 表 ARMv5TE 和 ARMv7-A 指令 集 
的 CPU。 

仅 当 编译 的 目标 ABI 为 armeabi-v7a 时 ,代码 第 8 行 和 第 9 行 才 被 运行 。 第 8 行 代 
码 向 GCC 编译 器 传递 参数 “-DHAVE_NEON 王 1”, 此 参数 为 GCC 定义 宏 符号 HAVE_ 
NEON.HAVE NEON 符号 的 值 为 1。 第 9 行 表 示 增 加 一 个 源 文 件 ,文件 名 称 为 
helloneon-intrinsics. c, Ж“. neon” 表 示 该 文件 仅 在 NEON 模式 下 才 被 编译 。 

代码 第 12 行 表示 在 Android МОК 编译 时 需要 链接 的 静态 库 文件 列表 ,这 里 只 有 一 
个 静态 库 为 cpufeatures。 代 码 13 行 表 示 编 译 时 需要 人 额外 链接 的 系统 库 文件 ,这 里 要 链 
接 的 系统 库 文件 应 为 /system/lib/liblog. so。 代 码 第 15 行 表 示 表 示 Android МОК 编译 
系统 需要 构建 共享 库 。 代 码 第 16 行 表示 通过 名 称 cpufeatures 引入 所 需 的 模块 。 


4. C 语言 文件 和 头 文件 
hello-neon 示例 中 C 语言 文件 和 头 文件 一 共有 3 个 ,分 别 是 helloneon-intrinsics. с, 


helloneon-intrinsics. h 和 helloneon. c. 
其 中 , ҺеПопеоп-іпігіпѕісѕ. c 实现 了 NEON 指令 集 的 FIR 算法 ,helloneon- 
intrinsics. h 是 头 文件 ,声明 调用 NEON 版 本 FIR 算法 的 函数 


void fir filter neon intrinsics (short * output, const short * input, const short * 


kernel, int width, int kernelSize); 
helloneon. c 中 首先 实现 了 C 语言 版 本 FIR 算法 ,其 调用 函数 为 : 


fir filter с (short * output, const short * input, const short * kernel, int width, int 


kernelSize) 
helloneon. c 中 还 定义 了 被 Java 代码 调用 的 接口 函数 ,核心 代码 如 下 : 


jstring Java com example neon HelloNeon stringFromJNI (JNIEnv * env, jobject thiz) 


288 CA (Ж 31 ) 


最 后 ,helloneon. c 分 别 在 代码 中 记录 NEON 和 C 语言 版 本 FIR 算法 的 运行 时 间 ， 
将 结构 以 字符 串 的 形式 返回 给 函数 调用 者 。 


= ER 


1. 简 述 Android МОК 开发 的 优势 和 不 足 。 

2. 说 明 Android МОК 应 用 程序 开发 的 一 般 步 又。 

3. 参考 NDK 的 tow-libs 示例 ,使 用 静态 库 实 现 AndroidNdkDemo 示例 中 加 法 运算 
的 函数 功能 。 

4. 使 用 NDK 能 够 提高 复杂 函数 的 运算 速度 ,但 程序 运行 效率 的 提升 并 不 容易 度 
量 。 分 别 使 用 C/C++ 和 Java 语言 设计 一 个 具有 复杂 运算 的 函数 ,通过 对 比 函 数 的 调用 
和 返回 时 间 , 分 析 МОК 对 提高 程序 运行 效率 的 能 力 。 

5. 简 述 在 代码 中 动态 检测 CPU 类 型 的 意义 。 


综合 示例 设计 与 开发 


本 章 将 以 "天气 预 报 软 件 ” 作 为 示例 ,综合 运用 以 往 章节 所 学 习 的 知识 和 技巧 ,从 需 
求 分 析 、 界 面 设计 、 模 块 设 计 和 程序 开发 等 几 个 方面 ,详细 介绍 Android 应 用 程序 的 设计 
思路 与 开发 方法 。 通 过 本 章 的 学 习 可 以 让 读者 掌握 Android 应 用 程序 的 设计 方法 和 多 
种 组 件 应 用 的 能 力 。 

本 章 学 习 目 标 : 

。 掌握 Android 应 用 程序 的 基本 设计 方法 和 思路 ; 

。 掌握 使 用 多 种 组 件 进行 Android 程序 开发 的 方法 。 
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通过 前 面 章节 的 学 习 , 读 者 应 该 已 经 掌握 了 一 些 Android 应 用 程序 的 开发 知识 和 方 
法 ,但 如 何 能 够 综合 地 运用 这 些 知识 和 方法 ,解决 实际 开发 中 所 遇 到 的 问题 ,还 是 一 个 需 
要 继续 学 习 和 探讨 的 问题 。 设 计 本 章 的 初衷 就 是 希望 读者 能 够 根据 实际 项 目的 需求 , 准 
确 分 析 Android 应 用 程序 开发 所 可 能 涉及 的 知识 点 ,通过 分 析 软 件 的 需求 ,快速 设计 出 
用 户 界 面 和 模块 结构 ,并 最 终 完成 应 用 程序 的 开发 和 调试 。 

本 章 提供 的 “天 气 预报 软件 ?是 一 个 略微 复杂 的 示例 。 在 这 个 综合 示例 中 ,有 一 个 显 
示 天 和 气 情况 的 用 户 界面 ,可 以 通过 图 片 和 文字 显示 当前 和 未 来 几 天 的 天 气 状 况 , 包 括 温 
JE .湿度 .风向 和 雨 雪 情况 等 。 这 些 天 气 数 据 是 通过 后 台 服 务 获取 的 ,这 个 后 台 服 务 按照 
一 定时 间 间 隔 , 从 中 国 天 气 网 上 获取 天 气 预 报信 息 , 并 将 天 气 信息 保存 在 后 台 服 务 中 。 
示例 还 需要 提供 基于 SMS 短信 的 天 气 数据 服务 ,其 他 手机 用 户 可 以 向 本 示例 所 在 的 手 
机 上 发 送 SMS 短信 ,在 短信 中 包含 特定 的 关键 字 , 则 可 以 将 已 有 的 天 气 情况 通过 SMS 
短信 回复 给 用 户 。 最 后 ,每 个 被 发 送 的 SMS 短信 都 会 被 记录 下 来 ,用 户 可 以 浏览 或 删除 
这 些 记录 信息 。 

从 上 面 的 描述 中 可 以 基本 了 解 软 件 的 功能 需求 ,但 为 了 将 需求 分 析 过 程 变 得 简单 明 
了 ,首先 找 出 用 户 界面 上 需要 显示 的 内 容 。 功 能 描述 中 有 “显示 天 气 情况 的 用 户 界面 "和 
“用 户 可 以 浏览 或 删除 这 些 记 录 信 息 ”, 除 此 以 外 ,一 般 应 用 软件 还 应 有 显示 配置 信息 的 
界面 。 因 此 ,本 示例 应 该 包含 三 个 用 户 界面 : 

(1) 显示 天 气 预报 的 用 户 界 面 ; 
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(2) 显示 已 发 送 SMS 短信 的 用 户 界面 ; 

(3) 浏览 和 设置 配置 信息 的 用 户 界面 。 

下 一 步 从 用 户 界面 出 发 ,分 析 隐 藏 在 界面 后 面 的 内 部 功能 ,这 些 功 能 则 是 程序 正常 
运行 的 基础 。 在 显示 天 气 预 报 的 用 户 界面 中 ,为 了 在 界面 上 显示 天 气 信息 , 则 需要 从 互 
联网 获取 天 气 数据 的 功能 ,并 将 天 气 数据 信息 保存 在 程序 内 部 。 而 在 显示 已 发 送 SMS 
短信 的 用 户 界 面 中 , 则 需要 提供 监视 接收 短信 关键 中 的 功能 ,并 且 支 持 发 送 包 含 天 气 信 
息 的 SMS 短信 。 除 此 以 外 ,为 了 能 够 浏览 短信 信息 ,还 需要 提供 数据 库 功能 ,将 短信 回 
复 信息 保存 到 数据 库 中 。 在 浏览 和 设置 配置 信息 的 用 户 界 面 中 ,应 提供 配置 信息 的 保存 
和 读 取 功能 ,并 能 够 恢复 软件 的 默认 设置 。 

根据 用 户 的 功能 需求 ,用 户 界 面 和 内 部 功能 的 关系 如 下 所 示 : 

(1) 显示 天 气 预 报 的 用 户 界面 。 

(D 获取 中 国 天 气 网 的 天 气 数据 ; 

О 保存 天 气 数据 信息 。 

(2) 显示 SMS 短信 的 用 户 界面 。 

O 根据 关键 字 监 视 SMS 短信 ; 

© 发 送 包含 天 气 信息 的 SMS 短信 ; 

C) 将 发 送 SMS 短信 的 相关 信息 写 入 数据 库 。 

(3) 浏览 和 设置 配置 信息 的 用 户 界 面 。 

CD 将 用 户 设置 的 配置 信息 保存 到 数据 库 ; 

© 启动 时 读 取 数据 库 中 的 配置 信息 ; 

@ 支持 恢复 缺 省 设置 。 

天 气 预报 软件 的 用 户 界面 和 内 部 功能 已 经 分 析 完 成 ,下 一 步 工 作 是 根据 用 户 界面 的 
需求 ,详细 设计 每 个 用 户 界 面 的 具体 内 容 , 并 划分 软件 的 功能 模块 ,以 及 分 析 软 件 功能 模 
块 之 间 的 调用 关系 。 
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1221 用 户 界 面 设计 


根据 需求 中 的 用 户 界面 分 析 , 应 用 程序 应 包含 三 个 主要 的 用 户 界面 ,这 里 则 需要 进 
一 步 分 析 每 个 用 户 界面 中 应 该 包含 哪些 显示 内 容 。 

在 显示 天 气 预报 的 用 户 界面 中 ,显示 目标 城市 的 当前 的 天 气 状况 ,包括 城市 名 称 、 温 
度 \ 湿 度 、 风 向 、 雨 雪 情 况 和 获取 数据 时 间 等 信息 。 在 界面 的 下 方 显示 未 来 四 天 的 天 气 状 
况 , 但 仅 包括 温度 和 雨 雪 情 况 。 

在 显示 已 发 送 SMS 短信 的 用 户 界面 中 ,显示 每 个 回复 短信 的 时 间 、 目 标 手 机 号 码 、 
城市 名 称 、 当 天 的 天 气 状 况 和 未 来 一 天 的 天 气 状况 。 

在 浏览 和 设置 配置 信息 的 用 户 界面 中 ,显示 希望 获取 天 气 预 报 的 城市 名 称 、 获 取 数 
据 的 频率 和 短信 监视 的 关键 字 , 并 允许 用 户 设置 是 否 提 供 短信 服务 ,以 及 是 否 记 录 回复 


短信 信息 。 
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根据 对 用 户 界 面 显示 内 容 的 分 析 , 绘 制 出 用 户 界面 的 草图 ,如 图 12. 1 所 示 。 


По) R £ Ñ: ХХХ, 2m?-o9-20 00:01:23 
РЕ: XX , Kf xx 
HA-A AA хх 

ОЖЖ: ХХХ, 2n] f-2 fas 
pei хх, АА XX 

-大 的 大 气 \ XX 


яи: [ WW 
ABAR д5: M 


УЖА. Xxx, 2n9— of-a2 Io:2y33] 
Tb хх ‚А хх 
AR- RKA: хх 


ОЖ. xxx, Amf- of -20 Ы 
PAIX, S Хх 


未 来 -大 的 天气 :XX ERA ER] PAAR 


12.1 用 户 界面 的 草图 


在 初步 完成 的 用 户 界 面 设计 后 ,下 一 步 进 入 应 用 程序 的 数据 库 设计 。 
1222 数据 库 设 计 


本 示例 主要 有 两 种 数据 需要 存储 ,一 个 是 配置 信息 , 另 一 个 是 SMS 短信 服务 信息 。 
因为 配置 信息 的 数据 量 很 小 , 从 Android 支持 的 存储 方式 上 分 析 , 可 以 保存 在 
SharePreference、 文 件 或 SQLite 数据 库 中 。SMS 短信 服务 信息 是 一 个 随 着 时 间 推 移 而 
不 断 增加 的 数据 ,属于 文本 信息 ,而 且 有 固定 的 格式 ,因此 适合 使 用 SQLite 数据 库 进 行 
存储 。 综 合 分 析 这 两 种 需要 存储 的 数据 ,选择 SQLite 数据 库 作 为 存储 数据 的 方法 。 

配置 信息 中 主要 保存 目标 城市 的 名 称 ,访问 中 国 天 气 网 更 新 天 气 信息 的 频率 ,请 求 
天 气 信息 服务 短信 的 关键 字 , 以 及 是 否 提供 短信 服务 和 是 否 记 录 短 信服 务 内容 。 配 置信 
息 的 数据 库 表 结构 如 表 12. 1 所 示 。 


表 12.1 配置 信息 的 数据 库 表 结 构 


属 性 数据 类 型 说 明 
id integer. | 自动 增加 的 主键 
city_name text 天 气 信息 查询 的 城市 名 
refresh_speed text 天 气 信息 查询 的 频率 ,单位 为 秒 /次 
"— "m EC LM кыа RM DN кы MM 
sms info text 是 否 记 录 发 出 的 SMS 短信 信息 
key_word text 短信 服务 的 关键 字 ,. 用 以 确定 哪 条 短信 和 是 请 求 天 气 服务 的 短信 


SMS 短信 服务 信息 主要 保存 请 求 天 气 服 务 短信 的 发 送 者 、 短 信 内 容 、 接 收 时 间 和 回 
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复 信 息 的 内 容 。SMS 短信 服务 信息 的 数据 库 表 结构 如 表 12.2 所 示 。 
表 12.2 SMS 短信 服务 信息 的 数据 库 表 结构 


属 性 数据 类 型 说 明 
_id integer 自动 增加 的 主键 
sms sender text 请 求 服务 短信 的 发 送 者 
sms_body text 请 求 服务 短信 的 内 容 信息 
sms receive time text 接收 到 请 求 服务 短信 的 时 间 


return_result text 回复 短信 的 内 容 


1223 程序 模块 设计 


从 功能 需求 上 分 析 , 可 以 将 整个 应 用 程序 划分 为 4 个 模块 ,分 别 是 用 户 界面 \ 后 台 服 
务 .数据库 适配器 和 短信 监听 器 ,各 模块 之 间 的 关系 如 图 12. 2 所 示 。 


用 户 界面 | 
Н 1 
天 气 信息 | 1Intent 启 动 、 停 止 服务 т 
: її 
后 台 服 务 d 
天 气 信息 E |2 
短信 监听 器 一 | 短信 发 送 子 模块 ШЫ 
服务 请 求 短信 1 
ito 一 [了 本] 
ES 数据 获取 子 模块 | 
短信 服务 信息 


а) ! 
SQLite 数 据 库 数据 库 适 配器 | 


12.2 模块 结构 图 


从 模块 结构 图 中 不 难看 出 ,后 台 服 务 是 整个 应 用 程序 的 核心 ,主要 包含 数据 获取 子 
模块 和 短信 服务 子 模 块 。 数 据 获取 子 模块 负责 周期 性 地 从 中 国 天 气 网 获取 天 气 信息 ; 短 
信服 务 子 模块 则 负责 处 理 接收 到 的 服务 请 求 短信 ,并 发 送 包 含 天 气 信息 的 短信 。 后 台 服 
务 由 用 户 界面 通过 Intent 启动 ,启动 后 的 后 台 服 务 可 以 在 用 户 界面 关闭 后 仍然 保持 运行 
状态 ,直到 用 户 通过 用 户 界面 发 送 Intent 停止 服务 .或 系统 因 资 源 不 足 而 强行 关闭 服务 。 

用 户 界面 从 后 台 服 务 获取 天 气 信息 .而 没有 直接 通过 网 络 访 问 中 国 天 气 网 的 天 气 数 
据 。 之 所 以 这 么 设计 ,一 方面 是 因为 后 台 服 务 使 用 了 工作 线程 ,通过 后 台 服 务 获取 天 气 
数据 可 以 避免 因 网 络 通信 不 畅 造 成 界面 失去 响应 ; 另 一 方面 ,在 用 户 关闭 界面 后 ,后 台 服 
务 仍然 需要 更 新 天 气 信息 ,以 保证 短信 服务 数据 的 准确 性 。 用 户 界面 通过 直接 调用 数据 
库 适 配器 ,向 SQLite 数据 库 中 读 写 配置 信息 ,或 对 SMS 短信 服务 信息 进行 操作 。 

短信 监听 器 是 一 个 BroadcastReceiver ,监视 所 有 接收 到 的 短信 。 如 果 短 信 中 包含 用 
户 自 定义 的 关键 字 ,短信 监听 器 则 会 认为 这 条 短信 是 天 气 服务 请 求 短 信 , 将 短信 的 相关 
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信息 写 人 后台 服 务 的 短信 服务 队列 。 当 然 , 如 果 用 户 在 配置 信息 中 选择 无 须 提供 短信 服 
55 ,短信 监听 器 仍然 继续 监听 所 有 短信 ,只 是 后 台 服 务 不 再 允许 将 服务 请 求 短信 写 和 信服 
务 队列 。 
数据 库 适 配器 封装 了 所 有 对 SQLite 数据 库 操作 的 方法 ,用 户 界 面 和 后 台 服务 会 调 
在 完成 用 户 界面 设计 数据 库 设 计 和 模块 设计 后 ,程序 的 设计 阶段 基本 完成 ,下 面 进 
入 程序 开发 阶段 。 


123 程序 开发 


123.1 工程 结构 


在 程序 开发 阶段 ,首先 确定 天 气 预报 软件 的 工程 名 称 为 WeatherDemo, 包 名 称 为 
edu. hrbeu. WeatherDemo。 然 后 根据 程序 模块 设计 的 内 容 , 建 立 WeatherDemo 示例 的 
文件 结构 。WeatherDemo 示例 源 代码 的 文件 结构 如 图 12. 3 所 示 。 


» [D HistoryActivityjava 
> [D SetupActivityjava 
b ËB) WeatherActivityjava 
b [J] WeatherDemojava 
4 iB edu.hrbeu.WeatherDemo.DB 
> D Configjava 
> [J] DBAdapterjava 
4 [B edu hrbeu.WeatherDemo.Service 
> [9 EncodeUtiljava 
b [D SmsReceiverjava 
b [J] WeatherAdapterjava 
b Ë) WeatherServicejava 
4 88 edu.hrbeu.WeatherDemo.SMS 
b 国 SimpleSmsjava 
» [Й SmsAdapterjava 
4 [B eduhrbeu.WeatherDemo. Weather 
> [J] Weatherjava 
Ë gen [Generated Java Files] 
B assets 
B bin 


4 (2 WeatherDemo 4 Ў res 
> щй Android 5.0.1 > 25 drawable 
4 ыс > © drawable-hdpi 
4 Д8 edu.hrbeu.WeatherDemo > @ drawable-Idpi 


b © drawable-mdpi 
© drawable-xhdpi 
4 {> layout 
E. data_rowxml 
Eš tab history.xml 
10 tab setup.xml 
10 tab weather.xml 
4 (5 menu 
В main.xml 
4 © values 
В colorxml 
В strings.xml 
Ë stylesxml 
[Ò AndroidManifestxml 
В proguard.cfg 
В project.properties 


12.3 WeatherDemo 示例 的 源 代 码 文件 


为 了 使 源 代码 文件 的 结构 更 加 清晰 ,WeatherDemo 示例 设置 了 多 个 命名 空间 ,分 别 
用 来 保存 用 户 界面 数据 库 、 后 台 服 务 .SMS 短信 和 和 天气 数据 的 源 代码 文件 。 命 名 空间 的 
名 称 以 及 说 明 参 考 表 12. 3。 

WeatherDemo 示例 将 不 同 用 途 的 源 代码 文件 放置 在 不 同 的 命名 空间 中 , 源 代码 文件 
的 名 称 和 用 途 可 以 参考 表 12. 4。 
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Ж 12.3 WeatherDemo 示例 的 命名 空间 


命名 空间 说 明 
edu. hrbeu. WeatherDemo 用 户 界 面相 关 的 源 代 码 文件 
edu. hrbeu. WeatherDemo. DB SQLite 数据 库 相 关 的 源 代 码 文件 
edu. hrbeu. WeatherDemo. Service 后 台 服 务 相关 的 源 代 码 文件 
edu. hrbeu. WeatherDemo. SMS SMS 短信 相关 的 源 代 码 文件 
edu. hrbeu. WeatherDemo. Weather 天 气 数 据 有 关 的 源 代 码 文件 


Ж 12.4 — WeatherDemo 示例 的 文件 用 途 说 明 


包 名 称 文 件 名 说 明 

HistoryActivity. java “历史 数据 ?页 的 Activity 
SetupActivity. java “系统 设置 "页 的 Activity 

. WeatherDemo = - 
WeatherActivity. java “天 气 预报 ”页 的 Activity 
WeatherDemo. java 程序 启动 默认 的 Activity 
Config. java 配置 信息 的 类 

. WeatherDemo. DB 
DBAdapter. java 数据 库 适 配器 
SmsReceiver. java 短信 监听 器 

. WeatherDemo. Service WeatherAdapter. java 数据 获取 模块 
WeatherService. java 后 台 服 务 


. WeatherDemo. SMS 


SimpleSms. java 


简化 的 SMS 短信 类 


SmsAdapter. java 


短信 发 送 模块 


. WeatherDemo. Weather 


Forecast. java 


Android 资源 文件 保存 在 /res 的 子 目录 中 
像 文 件 ,/res/layout 目录 中 保存 的 是 布局 文件 ,/res/values 目录 中 保存 的 是 用 来 定义 字 
符 串 和 颜色 的 文件 。 所 有 在 程序 开发 阶段 可 以 被 调用 的 资源 都 保存 在 这 些 目录 中 ,具体 
每 个 资源 文件 的 用 途 可 以 参考 表 12.5. 


表 12.5 资源 文件 名 称 与 用 途 


天 气 信 息 的 类 


。 其 中 /res/drawable 目录 中 保存 的 是 图 


资源 目录 x 件 说 — 8H 
icon. png 图 标 文 件 
sunny. png 调试 用 的 天 气 图 片 
drawable tab history. png “历史 数据 ”页 的 图 标 


tab_setup. png 


“系统 设置 "页 的 图 标 


tab_weather. png 


“天 气 预 报 ” 页 的 图 标 
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资源 目录 3E 件 说 明 

data_row. xml “历史 数据 ”页 ListActivity 的 每 行 数据 的 布局 
tab_history. xml “历史 数据 ”页 的 布局 

layout 
tab_setup. xml “系统 设置 "页 的 布局 
tab_weather. xml “天 气 预 报 ” 页 的 布局 
color. xml 保存 颜色 的 XML 文件 

values 
string. xml 保存 字符 串 的 XML 文件 


在 定义 了 所 有 文件 和 类 的 用 途 后 ,下 一 步 将 依据 程序 模块 结构 图 (图 12. 2) ,按照 自 
底 向 上 的 顺序 对 每 个 模块 进行 详细 的 介绍 。 自 底 向 上 介绍 有 利于 理解 模块 之 间 的 调用 
关系 ,也 避免 了 在 介绍 上 层 模 块 时 ,读者 不 了 解 所 调用 的 下 层 模 块 的 问题 。 


1232 数据 库 适 配器 


数据 库 适 配器 是 最 底层 的 模块 ,主要 用 于 封装 用 户 界面 和 后 台 服 务 对 SQLite 数据 
库 的 操作 。 数 据 库 适 配器 的 核心 代码 主要 在 DBAdapter. java 文件 中 ,在 介绍 数据 库 适 
配器 的 核心 代码 前 ,首先 了 解 一 下 用 户 保 存 配置 信息 的 类 文件 Config. java, 

Config. java 文件 的 全 部 代码 如 下 : 


* package edu.hrbeu.WeatherDemo.DB; 

2 

3 public class Config ( 

4 public static String CityName; 

5 public static String RefreshSpeed; 

6 public static String ProvideSmsService; 
1 public static String SaveSmsInfo; 

8 public static String KeyWord; 

9 

10 public static void LoadDefaultConfig|()( 
qu CityName- "101050101"; 

32 RefreshSpeed- "60"; 

13 ProvideSmsService= "true"; 

14 SaveSmsInfo= "true"; 

15 KeyWord- "NY"; 

16 } 

Ay ғ} 


从 代码 中 不 难看 出 .公有 静态 属性 CityName, RefreshSpeed, ProvideSmsService、 
SaveSmsInfo 和 KeyWord, 完 全 对 应 数据 库 中 保存 配置 信息 表 的 属性 (参照 表 12. 1) 。 在 
程序 启动 后 ,保存 在 数据 库 中 的 城市 名 称 、 更 新 频率 、 是 否 提 供 短 信服 务 、 是 否 保存 短信 


296 CA (第 ЗА) 


信息 和 关键 字 等 内 容 ,将 被 读 取 到 这 个 Config 类 中 , 供 其 他 模块 做 逻辑 判断 时 使 用 。 
代码 第 10 行 的 LoadDefaultConfig() 函 数 保存 了 程序 内 置 的 配置 参数 。 此 函数 会 在 
两 个 情况 下 被 调用 ,一 是 用 户主 动 选择 “恢复 默认 设置 ”; 二 是 首次 启动 程序 时 ,用 来 初始 
化 保存 配置 参数 的 数据 库 。 
DBAdapter 类 与 以 往 介 绍 过 的 数据 库 适 配器 类 相似 ,都 具有 继承 
SQLiteOpenHelper 的 帮助 类 DBOpenHelper。DBOpenHelper 在 建立 数据 库 时 ,同时 建 
立 两 个 数据 库 表 ,并 对 保存 配置 信息 的 表 进 行 初始 化 ,初始 化 的 相关 代码 在 第 42 一 
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private static final String DB NAME- "weather app.db"; 
private static final String DB TABLE CONFIG- "setup config"; 
private static final String DB CONFIG ID-"1"; 


private static final int DB VERSION-1; 


public static final String KEY ID-" id"; 

public static final String KEY CITY NAME- "city name"; 

public static final String KEY REFRESH SPEED- "refresh speed"; 
public static final String KEY SMS SERVICE- "sms service"; 
public static final String KEY SMS INFO- "sms info"; 

public static final String KEY KEY WORD- "key word"; 


private static final String DB TABLE SMS- "sms data"; 
public static final String KEY SENDER- "sms sender"; 


public static final String KEY BODY-"sms роду"; 
public static final String KEY RECEIVE TIME- "sms receive time"; 


public static final String KEY RETURN RESULT- "return result"; 


xx 静态 Helper 类 ,用 于 建立 ,更 新 和 打开 数据 库 */ 
private static class DBOpenHe1per extends SQLiteOpenHelper { 
public ОВОрепНе1рег (Context context, String name, CursorFactory factory, 
int version) { 
super (context, name, factory, version); 
) 


private static final String DB CREATE CONFIG- "create table "+ 
DB TABLE СОМЕІС+ " ("+КЕҮ ID+" integer primary key autoincrement, "+ 
KEY CITY МАМЕ+ " text not null, "+КЕҮ REFRESH SPEED-*" text, "+ 
KEY SMS SERVICE*" text, "+KEY SMS INFO*" text, "+ 


KEY KEY WORD*" text);"; 


private static final String DB CREATE SMS- "create table "+ 
DB TABLE 5М5+ " ("+ КЕҮ ID*" integer primary key autoincrement, "+ 
KEY SENDER-" text not null, "+КЕҮ BODY-" text, "+ 
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34 KEY RECEIVE TIME+" text, "+ KEY RETURN RESULT+" text);"; 
35 

36 @ Override 

37 public void onCreate (SQLiteDatabase _ db) ( 

38 _db.execSQL (DB_CRERTE CONFIG); 

39 _db.execSsQL (DB_CREATE SMS); 

40 

41 // 初 始 化 系统 配置 的 数据 表 

42 Config.LoadDefaultConfig () ; 

43 ContentValues newValues- new ContentValues () ; 

44 newValues.put(KEY CITY NAME, Config.CityName); 

45 newValues.put(KEY REFRESH SPEED, Config.RefreshSpeed); 

46 newValues.put(KEY SMS SERVICE, Config.ProvideSmsService); 
47 newValues.put(KEY SMS INFO, Config.SaveSmsInfo); 

48 newValues.put(KEY KEY WORD, Config.KeyWord); 

49 .db.insert(DB TABLE CONFIG, null, newValues); 

50 } 

51 

52 @ Override 

53 public void опурогаде (SQLiteDatabase db, int oldVersion, int newVersion)( 
54 . db.execSQL("DROP TABLE IF EXISTS "+DB TABLE CONFIG); 

55 . db.execSQL("DROP TABLE IF EXISTS "*DB CREATE SMS); 

56 onCreate( db); 

57 } 

58 } 


ТЕ DBAdapter 类 中 ,用 户 界 面 会 调用 SaveConfig() 和 LoadConfigO ,从 SQLite 数据 
库 中 保存 和 读 取 配置 信息 。 保 存 配置 信息 时 ,SaveConfig() 函 数 会 将 Config 类 中 的 公 
静态 属性 写 和 数据库; 反之 ,LoadConfig() 会 将 数据 库 中 的 配置 信息 写 入 Config 类 中 的 
公有 静态 属性 。SaveConfig() 和 LoadConfig() 的 代码 如 下 : 


1 public void SaveConfig(){ 


2 ContentValues updateValues- new ContentValues (); 

3 updateValues.put(KEY CITY NAME, Config.CityName); 

4 updateValues.put(KEY REFRESH SPEED, Config.RefreshSpeed); 

5 updateValues.put(KEY SMS SERVICE, Config.ProvideSmsService); 

6 updateValues.put(KEY SMS INFO, Config.SaveSmsInfo); 

7 updateValues.put(KEY KEY WORD, Config.KeyWord); 

8 db.update(DB TABLE CONFIG, updateValues, KEY ID* "= "+0В CONFIG ID, null); 

9 Toast.makeText (context, "< 5t Ut ЕЛ 2)", Toast -LENGTH SHORT).show(); 
10 ] 

11 


12 public void LoadConfig () { 
13 Cursor result=db.query(DB TABLE CONFIG, new String[] ( KEY ID, KEY CITY NAME, 
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so sais sn) 


14 
15 
16 
17 
18 
19 
20 


21 


25 


KEY REFRESH SPEED,KEY SMS SERVICE, KEY SMS INFO, KEY KEY WORD), 

KEY _ID+"="+DB CONFIG ID, null, null, null, null); 
if(result.getCount ()==0 || !result.moveToFirst ()) { 

return; 

} 
Config.CityName- result.getString(result.getColumnIndex(KEY CITY NAME)); 
Config.RefreshSpeed- result.getString (result.getColumnIndex (KEY REFRESH - 
SPEED)) ; 
Config.ProvideSmsService- result.getString (result.getColumnIndex(KEY SMS 
SERVICE)); 
Config.SaveSmsInfo- result.getString (result.getColumnIndex (KEY SMS INFO)); 
Config.KeyWord- result.getString (result.getColumnIndex (KEY KEY WORD)); 
Toast.makeText (context, "系统 设置 读 取 成 功 ", Toast.LENGTH SHORT).show(); 

} 


另 一 个 会 调用 DBAdapter 类 的 是 后 台 服 务 , 即 WeatherService 类 。 后 台 服 务 主要 调 
用 SaveOneSms(SimpleSms sms)、DeleteAllSms() 和 GetAllSms() 函 数 ,分 别 用 来 保存 
SMS 短信 记录 ,删除 所 有 SMS 数据 记录 和 获取 所 有 SMS 数据 记录 。 在 GetAllSmsO PR 
数 中 ,调用 了 一 个 私有 函数 ToSimpleSms(Cursor cursor) ,用 来 将 从 数据 库 获 取 的 数据 
转换 为 SimpleSms 实例 数组 。SimpleSms 类 将 在 下 一 小 节 进 行 介绍 ,下 面 先 给 出 
SaveOneSms(SimpleSms sms) DeleteAllSms() 和 GetAllSms O 函数 的 代码 。 


£ 
2 
3 
4 
5 
6 
7 
8 
8 


10 


public void SaveOneSms (SimpleSms sms) ( 


ContentValues newValues- new ContentValues () ; 


5 

H k 
newValues.put(KEY SENDER, sms.Sender); [] б 

newValues.put(KEY BODY, sms.Body); 

newValues.put(KEY RECEIVE TIME, sms.ReceiveTime); 

newValues.put(KEY RETURN RESULT, sms.ReturnResult); 

db.insert(DB TABLE SMS, null, newValues); 
) 
public long DeleteAllSms () { 

return db.delete(DB TABLE SMS, null, null); 
) 
public SimpleSms[] GetAllSms () { 

Cursor results-db.query (DB TABLE SMS, new String[] ( KEY ID, KEY SENDER, 

KEY BODY, KEY RECEIVE TIME, KEY RETURN RESULT), 
null, null, null, null, null); 
return ToSimpleSms (results); 

} 
private SimpleSms[] ToSimpleSms (Cursor cursor) { 

int resultCounts- cursor.getCount () 7 

if(resultCounts-- 0 ||!cursor.moveToFirst ()) { 


return null; 
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22 } 

23 

24 SimpleSms[] sms- new SimpleSms [resultCounts]; 

25 for (int i-0; i«resultCounts; i++){ 

26 sms [i]- new SimpleSms (); 

27 sms [i].Sender- cursor.getString (cursor.getColumnIndex (KEY SENDER)); 

28 sms [i].Body- cursor.getString (cursor.getColumnIndex (KEY BODY)); 

29 sms [i].ReceiveTime- cursor.getString (cursor.getColumnIndex (KEY 

RECEIVE TIME)); 

30 sms[i].ReturnResult- cursor.getString (cursor.getColumnIndex (KEY RETURN - 
RESULT)); 

31 cursor.moveToNext () 7 

32 } 

33 return sms; 

34 ) 


1233 短信 监听 器 


短信 监听 器 本 质 上 是 BroadcastReceiver, 用 于 监听 Android 系统 所 接收 到 的 所 有 
SMS 短 消息 ,可 以 在 应 用 程序 关闭 后 仍然 继续 运行 ,核心 代码 在 SmsReceiver. java 文件 
中 。 同 样 在 介绍 SmsReceiver 类 前 , 先 说 明 用 来 保存 SMS 短信 内 容 和 相关 信息 的 
SimpleSms 类 。android. telephony. SmsMessage 是 Android 提供 的 短信 类 ,但 这 里 需要 
一 个 更 精简 小 巧 的 类 ,保存 少量 的 信息 ,因此 构造 了 SimpleSms 类 , 仅 用 来 保存 短信 的 
发 送 者 、 内 容 、 接 收 时 间 和 返回 结果 。 这 里 的 “返回 结果 ” 指 的 是 返回 包含 天 气 信 息 的 短 
信 内 容 。 

SimpleSms. java 文件 完整 代码 如 下 。 


» package edu.hrbeu.WeatherDemo.SMS; 

2 import java.text.SimpleDateFormat; 

3 

4 public class SimpleSms { 

5 public String Sender; 

6 public String Body; 

ri public String ReceiveTime; 

8 public String ReturnResult; 

9 

10 public SimpleSms () ( 

11 $ 

12 public SimpleSms (String sender, String body) { 
13 this.Sender- sender; 

14 this.Body-body; 

15 SimpleDateFormat tempDate- new SimpleDateFormat ("yyyy- MM- dd"+ " "+ 
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"hh:mm:ss"); 
16 this.ReceiveTime- tempDate.format (new java.util.Date()); 
17 this.ReturnResult- ""; 
18 } 
19 } 


代码 第 5 行 到 第 8 行 的 属性 Sender, Body, ReceiveTime 和 ReturnResult. 4 Jl € z& 
SMS 短信 的 发 送 者 .内 容 . 接 收 时 间 和 返回 结果 。 代 码 的 第 15 行 和 第 16 行 在 
SimpleSms 类 的 构造 函数 中 ,直接 将 系统 时 间 以 “年 -月 -日 小 时 :分 : 秒 ” 的 格式 保存 在 
ReceiveTime 属性 中 。 

SmsReceiver 类 继承 BroadcastReceiver, 重 载 7 onReceive() 函 数 。 系 统 消息 的 识别 
和 关键 字 的 识别 并 不 复杂 ,只 要 接收 android. provider. Telephony. SMS_RECEIVED 类 
型 的 系统 消息 , 则 表明 是 Android 系统 接收 到 了 短信 。 将 短信 的 内 容 拆 分 后 ,判断 消息 
内 容 是 否 包 含 用 户 定 义 的 关键 字 , 则 可 判断 该 短信 是 否 为 天 气 服务 请 求 短信 。 下 面 给 出 
SmsReceiver. java 文件 的 核心 代码 。 


Я; public class SmsReceiver extends BroadcastReceiver( 


z private static final String SMS ACTION =" android. provider. Telephony. SMS _ 
RECEIVED"; 

3 

4 @override 

5 public void onReceive (Context context, Intent intent)( 

6 if (intent.getAction().equals (SMS ACTION))( 

7 Bundle bundle- intent .getExtras (); 

8 if (bundle!-null)( 

9 Object[] objs= (Object []) bundle.get ("pdus") ; 

10 SmsMessage[] messages- new SmsMessage [objs.length]; 

11 for (int i=0; i<objs.length; і++) { 

12 messages [i]= SmsMessage .createFromPdu ( (byte[])objs[i]); 

13 } 

14 String smsBody-messages [0] .getDisplayMessageBody (); 

15 String smsSender=messages [0] .getDisplayOriginatingAddress () ; 

16 if (smsBody. trim ( ). equals (Config. KeyWord) && Config. 

ProvideSmsService.equals ("true"))( 

17 SimpleSms simpleSms=new SimpleSms (smsSender, smsBody) ; 

18 WeatherService.RequerSMSService (simpleSms); 

19 Toast.makeText (context，" 接 收 到 服务 请 求 短信 "，Toast 

-LENGTH SHORT) .show () ; 

20 } 

21. H 

22 } 

28 } 
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代码 第 10 行将 带 有 pdus 字符 串 特征 的 对 象 ,通过 bundle. get O 函数 提取 出 来 ,并 在 
代码 第 12 行使 用 SmsMessage. CreateFromPdu() 函数 构造 SmsMessage 实例 。 在 代码 
第 12 行使 用 循环 语句 是 因为 接收 到 的 短信 可 能 不 止 一 条 ,但 从 第 14 行 和 第 15 行 代码 上 
看 ,这 里 只 处 理 第 1 条 短信 。 代 码 第 17 行 构造 SimpleSms 实例 ,然后 在 代码 第 18 行 调 
用 WeatherService 类 的 RequerSMSService CO) 函数 ,将 SimpleSms 实例 添加 到 短信 队 
列 中 。 

最 后 ,在 AndroidManifest. xml 文件 中 注册 短信 监听 器 SmsReceiver, 并 声明 可 接收 
短信 的 用 户 许 可 android. permission. RECEIVE_SMS。 需 要 注意 的 是 ,如 果 注 册 的 组 件 
不 在 根 命名 空间 中 , 则 需要 将 子 命 名 空间 写 在 类 的 前 面 ,例如 下 面 在 代码 第 1 行 中 ,因为 
SmsReceiver. java 文件 在 edu. hrbeu. WeatherDemo. Service 命名 空间 下 ,而 不 在 根 命名 
空间 edu. hrbeu. WeatherDemo 下 ,因此 注册 组 件 时 需要 在 类 名 SmsReceiver fij Й 
加 . Service。 


T < receiver android:name- ".Service.SmsReceiver" > 

2 «intent- filter» 

3 «action android:name- "android.provider.Telephony.SMS 
RECEIVED" /» 

4 < /intent- filter» 


a 


< /receiver» 


6 <uses-permission android:name= "android.permission.RECEIVE SMS"/» 


1234 后 合 服务 


后 台 服 务 是 WeatherDemo 示例 的 核心 模块 ,在 用 户 启 动 后 持续 在 后 台 运 行 ,直到 用 
户 手动 停止 服务 。 后 台 服 务 主要 有 两 个 功能 ,一 是 发 送 包 含 天 气 信息 的 SMS 短信 (短信 
发 送 子 模块 ) ,二 是 周期 性 地 获取 中 国 天 气 网 的 天 气 数据 (数据 获取 子 模块 ) 。 


1. 短信 发 送 子 模块 


后 台 服 务 在 单独 的 线程 上 运行 ,首先 调用 ProcessSmsList() 函 数 , 检 查 短信 队列 中 
是 否 有 需要 回复 的 短信 ,然后 调用 GetWeatherData O 函数 获取 天 气 数 据 , 最 后 线程 暂停 
1 秒 , 以 释放 CPU 资源 。WeatherDemo 示例 后 台 服 务 的 核心 代码 在 WeatherService 
. java 文件 中 ,下 面 是 线程 调用 函数 的 部 分 代码 。 


private static ArrayList« SimpleSms> smsList- new ArrayList« SimpleSms> (); 


private Runnable backgroudWork- new Runnable () ( 
@ Override 
public void run () { 
try( 
while (!Thread.interrupted ()) { 


co ч бс ат в шю н 


ProcessSmsList (); 
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9 GetWeatherData (); 

10 Thread.sleep (1000); 

11 } 

12 ) catch (InterruptedException е){ 
13 e.printStackTrace|(); 

14 ) 

15 } 

16 }; 


ProcessSmsList O 9 d 3 (5 91] 4 smsList ,并 根据 Weather 类 中 保存 的 天 气 
数据 ,向 请 求 者 的 发 送 回复 短信 。WeatherService. java 文件 的 ProcessSmsList O 函数 代 
码 如 下 。 


E private void ProcessSmsList () { 

2 if (smsList.size()--0)( 

3 return; 

4 } 

5 SmsManager smsManager- SmsManager.getDefault () ; 

6 PendingIntent mPi- PendingIntent.getBroadcast (this, 0, new Intent (), 0); 

7 while (smsList.size()»0)( 

8 SimpleSms sms- smsList.get (0); 

9 smsList.remove (0); 

10 smsManager. sendTextMessage (sms. Sender, null, Weather. GetSmsMsg (), mPi, 
null); 

її sms.ReturnResult- Weather.GetSmsMsg () ; 

12 SaveSmsData (sms) ; 

13 } 

14 ) 


发 送 短信 是 使 用 SmsManager 对 象 的 sendTextMessage() 方 法 ,该 方法 一 共 需 要 
5 个 参数 ,第 1 个 参数 是 收 件 人 地 址 ,第 2 个 参数 是 发 件 人 地 址 ,第 3 个 参数 是 短信 正文 ， 
第 4 个 参数 是 发 送 服务 .第 5 个 参数 是 送 达 服务 。sendTextMessage() 方 法 的 收 件 人 地 
址 和 短信 正文 是 不 可 为 空 的 参数 ,而 且 一 般 GSM 规范 要 求 短信 内 容 要 控制 在 70 个 汉字 
以 内 。 代 码 第 8 行 的 Weather. GetSmsMsg() ,用 来 获得 供 回复 短信 使 用 的 天 气 信息 , 因 
为 考虑 到 短信 的 字数 限制 , 仅 返 回 当 天 和 未 来 一 天 的 天 气 状况 。 下 面 给 出 Weather. java 
文件 的 完整 代码 。 

Weather. java 文件 的 代码 如 下 。 


package edu.hrbeu.WeatherDemo.Weather; 


public class Weather { 


1 
2 
3 
4 
5 public static String city;//c3 
6 


public static String province;//c7 
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public static String date; //#0 


public static String current weather; 


public static String current temperature; 


public static String current windD; 


public static String current windP; 


public static String 
public static String 


public static String 
public static String 
public static String 
public static String 
public static String 


public static String 
public static String 


public static String 
public static String 


weatherD- new String[3]; 
weatherN- new String[3]; 


temperatureD- new String[3]; 
temperatureN- new String[3]; 
humidity- new String[3]; 


windDD- new String[3]; 
windDN- new String[3]; 


windPD- new String[3]; 
windBN- new String[3]; 


sunrise-new String[3]; 


sundown-new String[3]; 


public static String GetSmsMsgD () { 


String msg-""; 


msgt-cityt","; 


msg*-weatherD[0]-* ", "+ temperatureD[0]-". "; 


//fa 
//fb 


//£c 
//ка 


//fe 
//EE 


//fg 
//fh 


//fi 
A 


msg+=day[0] .day_of week+", "*day[0].conditiont", "+ 
day[0] .high+ "/"+ day[0] .low; 


return msg; 


} 


public static String GetSmsMsgN () { 


String msg=""; 


msg+=city+","; 


msg+=weatherN[0]+ ", "+ temperatureN[0]-". "; 


msgt-day[0].day of меек+ ", "*day[0].conditiont", "+ 


day [0] .high+ "/"+ day [0] . low; 


return msg; 
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2. 数据 获取 模块 


天 气 数据 是 从 中 国 天 气 网 提供 的 气象 数据 开放 平台 获取 的 ,使 用 气象 数据 开放 平台 
API, 首 先 需 要 申请 个 人 key。 调 试 WeatherDemo 示例 时 需要 网 络 环境 。 气 象 数 据 开 放 
平台 的 地 址 是 http://openweather. weather. com. cn/ 。 通 过 查阅 提供 的 API 文档 ,可 知 
其 天 气 调用 方式 为 使 用 GET HR ,获取 地 址 格式 为 : 


http://open.weather.com.cn/data/? areaid=""&type=""&date=""&appid=""&key=""; 


其 中 ,areaid 表示 获取 天 气 数据 城市 的 区 域 id,appid 与 key 申请 后 可 获得 。 最 终 返 回 的 
数据 格式 为 JSON 格式 ,可 免费 获得 三 天 内 的 天 气 预报 。 具 体 获取 方式 以 及 解析 方法 参 
见 中 国 天 气 网 提供 的 АРІ 文档, 在 此 不 再 歼 述 。 

最 后 ,在 AndroidManifest. xml 文件 中 注册 WeatherService, 并 声明 两 个 用 户 许可 : 
连接 互联 网 和 发 送 SMS 短信 。 


1 < service android:name- ".Service.WeatherService"/» 
2 <uses- permission android:name= "android.permission.INTERNET" /> 
3 


<uses- permission android:name= "android.permission.SEND SMS"/> 


1235 用 户 界面 


在 用 户 界面 设计 上 ,采用 可 多 分 页 快速 切换 的 TabHost 控件 。WeatherDemo 示例 
TabHost 控件 的 每 个 标签 页 与 一 个 Activity 相关 联 ,这样 就 可 以 将 不 同 标签 页 的 代码 放 
在 不 同 的 文件 中 ,而 且 每 个 标签 页 都 可 以 有 独立 的 选项 菜单 。 

WeatherDemo 类 是 继承 TabActivity 的 Tab 标签 页 , 共 设 置 3 个 标签 页 。 第 一 个 标 
签 页 TAB1 的 标题 为 “天 气 预 报 ”, 关 联 的 Activity 为 WeatherActivity; 第 二 个 标签 页 
TAB2 的 标题 为 “历史 数据 ,关联 Activity 为 HistoryActivity; 第 三 个 标签 页 TAB2 的 标 
题 为 “系统 设置 ,关联 Activity 为 SetupActivity。 

WeatherDemo. java 文件 的 完整 代码 如 下 。 


package edu.hrbeu.WeatherDemo; 


import android.app.TabActivity; 


import android.content.Intent; 
import android.widget.TabHost; 


3. 

2 

3 

4 

5 import android.os.Bundle; 
6 

Т 

8 public class WeatherDemo extends TabActivity { 
9 


@ Override 
10 public void onCreate (Bundle savedInstanceState) { 
11 super.onCreate (savedInstanceState); 
A2 


13 TabHost tabHost- getTabHost () ; 


El 
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14 tabHost.addTab (tabHost .newTabSpec ("TAB1") 

15 .setIndicator ("Ж ^i #48 ", getResources () .getDrawable (R.drawable 
-tab weather)) 

16 -setContent (new Intent (this, WeatherActivity.class))); 

£7 

18 tabHost .addTab (tabHost .newTabSpec ("TAB2") 

19 .setIndicator ("JJ E {Ж ", getResources () .getDrawable (R.drawable 
-tab history)) 

20 -setContent (new Intent (this, HistoryActivity.class))); 

21 

22 tabHost.addTab (tabHost . newTabSpec ("ТАВЗ") 

23 .setIndicator ("系统 设置 ", getResources () .getDrawable (R.drawable 


сар setup)) 


24 .setContent (new Intent (this, SetupActivity.class))); 


26 } 


WeatherDemo. java 中 的 代码 只 是 用 户 界 面 的 框架 ,设置 了 Tab 标签 页 的 图 标 、 标 题 
和 所 关联 的 Activity, 标 签 页 中 的 具体 显示 内 容 还 要 依赖 于 每 个 Activity 所 设置 的 界面 
布局 。 下 面 就 分 别 介 绍 WeatherActivity, HistoryActivity 和 SetupActivity。 


1. WeatherActivity 


WeatherActivity FE Ж лу X AC f É 
时 并 不 能 够 显示 最 新 的 天 气 信 息 , 用 户 需 要 通过 选项 菜 gp 
单 的 “启动 服务 ”开启 后 台 服 务 A A a k 
新 的 天 气 状 况 。 此 外 ,选项 菜单 还 提供 “停止 服务 ”和 zana 
“退出 ?选项 。 

WeatherActivity 使 用 的 布局 文件 是 tab_ weather 
. xml, 这 是 个 较为 繁琐 的 界面 布局 ,多 次 使 用 了 垂直 和 
水 平 的 线性 布局 。WeatherActivity 的 界面 布局 和 代码 
并 不 难以 理解 ,因此 这 里 不 再 给 出 WeatherActivity 
.java 和 tab weather. xml 具体 代码 。 


2. HistoryActivity 


HistoryActivity 主要 用 来 显示 SQLite 数据 库 中 的 
短信 服务 信息 ,显示 的 内 容 包括 发 送 者 的 手机 号 码 、 时 
间 和 回复 短信 内 容 , 如 图 12.5 所 示 。 为 了 能 够 以 列表 
的 形式 显示 多 行 数据 ,并 且 定 制 每 行 数据 的 显示 布局 ， 


这 里 使 用 了 以 往 章节 没有 介绍 过 的 ListActivity 图 12.4 WeatherActivity 用 户 界面 


(Android. арр. ListActivity) 。 


如 图 12.4 所 示 。WeatherActivity 在 启动 


系统 设置 
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WeatherDemo 
WeatherDemo 


x^mü 


天 气 预报 历史 数据 


13333 , 2015-06-14 02:21:35 


险 尔 滨 . 00,29. 
(1) 发 送 者 : 12011116666, 2015-06-14 02:21:54 
FEMI , 00,29. 
(2) 发 送 者 : 12011119990, 2015-06-140222:23 
00,29. 
发 送 者 12011110000 , 2015-06-14 02:22:51 
ЈА, 00,29. 
发 送 者 12011115555 , 2015-06-14 02:22:56 


(5) 发 送 者 : 12036233352, 2015-06-14 02:23:18 
лж. 00,29. 
(6) 发 送 者 13036232567 , 2015-06-14 02:23:27 
раж , 00,29. 


图 12.5 HistoryActivity A A R E 


ListActivity 可 以 不 通过 setContentView() 设 置 布 
局 ,也 不 必 重 载 onCreate() 函 数 , 而 直接 将 显示 列表 加 载 到 ListActivity ,提高 了 使 用 的 便 
利 性 。 在 WeatherDemo 示例 中 ,仍然 使 用 setContentView() 设 置 布 局 ,这 样 做 的 好 处 是 
可 以 在 界面 中 设置 更 为 复杂 的 显示 元 素 , 例 如 在 列表 上 方 增加 了 提示 信息 “SQLite 数据 
库 中 的 短信 服务 信息 ”。 下 方 的 代码 是 HistoryActivity. java 文件 的 onCreate() 函 数 中 
的 设置 布局 和 加 载 适配器 的 关键 代码 。 


setContentView(R.layout.tab history); 
2 setListAdapter (dataAdapter); 


tab. history. xml 是 History Activity 的 布局 文件 ,下 面 先 分 析 一 下 tab. history. xml 
的 内 容 。tab_history. xml 文件 的 完整 代码 如 下 。 


x «?xml version- "1.0" encoding- "utf- 8"?» 

2  «LinearLayout xmlns:android- "http: //schemas .android.com/apk/res/android" 
android:orientation- "vertical" 
android:layout width- "fill parent" 
android:layout height- "fill parent" 


3 

4 

5 

6 android:background- "ё drawable/black"» 

7 

8 <TextView android:layout width= "wrap content" 

9 android:layout height- "wrap content" 

10 android:text="sQLite 数 据 库 中 的 短信 服务 信息 :"> 


11 < /TextView> 


12 <ListView android:id- "ё android:id/list" 
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13 android:layout width="fill parent" 
14 android:layout height="wrap content" 
15 android:layout_marginTop= "2dip"> 

16 < /ListView» 


17 </LinearLayout> 


tab_history. xml 在 代码 的 第 12 行 至 第 16 行使 用 了 ListView 控件 ,并 定义 其 系统 
ID 值 为 @android:id/list, List View 的 数据 列 配器 是 通过 setListAdapter(dataAdapter) 
设置 的 。ListView 使 用 的 是 自 定义 布局 ,布局 保存 在 data. row. xml 文件 中 ,data_row 
. xml 的 完整 代码 如 下 。 


1  «LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" 
2 android:orientation- "horizontal" 

3 android:layout width- "fill parent" 
4 android:layout height- "fill parent" 
5 android:background- "6 drawable/white" 
6 
p 
8 
9 


android:layout marginTop- "2аір"> 


XLinearLayout android:orientation- "vertical" 


android:layout width- "fill parent" 


10 android:layout height- "fill parent" 

A 

12 «TextView android:id- "ё id/data row 01" 

13 android:layout gravity- "center vertical" 
14 android:layout width- "fill parent" 

15 android:layout height- "wrap content" 

16 android:textSize- "12dip" 

17 android:textColor- "ё drawable/black"/» 

18 

19 « TextView android:id- "ё id/data row 02" 

20 android:layout gravity- "center vertical" 
21 android:layout width- "fill parent" 

22 android:layout height- "wrap content" 

23 android:textSize- "12dip" 

24 android:textColor- "6 drawable/black" 

25 android:layout marginTop- "Заір"/> 

26 < /LinearLayout» 


27 «/Linearlayout» 


Android 提供 的 数据 适配器 仅 允 许 保存 字符 串 数 组 或 列表 对 象 , 如 果 和 希望 使 用 自 定 
义 布局 , 则 需要 实现 自 定义 的 数据 适配器 ,并 继承 Android 提供 的 BaseAdapter 
(Android. widget. BaseAdapter) 对 象 。 自 定义 的 数据 适配器 在 SmsAdapter. java 文件 
中 ,其 完整 代码 如 下 。 
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package edu.hrbeu.WeatherDemo.SMS; 


е 


№ 


import android.content.Context; 

import android.view.LayoutInflater; 

import android.view.View; 

import android.view.ViewGroup; 

import android.widget.BaseAdapter; 

import android.widget.TextView; 

import edu.hrbeu.WeatherDemo.DB.DBAdapter; 
10 import edu.hrbeu.WeatherDemo.R; 


о © мы O O ^ ш 


13 public class SmsAdapter extends BaseAdapter( 


14 private LayoutInflater mInflater; 

15 private static DBAdapter dbAdapter; 
16 private static SimpleSms[] smsList; 
17 

18 public SmsAdapter (Context context) { 
19 mInflater- LayoutInflater.from(context); 
20 dbAdapter- new DBAdapter (context); 
21 dbAdapter.open () ; 

22 smsList- dbAdapter.GetAllSms(); 
23 y 

24 

25 public static void RefreshData|()( 

26 smsList- dbAdapter.GetAllSms(); 
27 } 

28 @override 

29 public int getCount () ( 

30 if (smsList==nul1) 

Зі Feturn 0; 

32 else 

33 return smsList.length; 

34 } 

35 @ Override 

36 public Object getItem(int position) { 
37 if (smsList==nul1) 

38 return 0; 

39 else 

40 return smsList [position]; 
41 } 

42 @ Override 

43 public long getItemId (int position) { 


44 return position; 


45 
46 
47 
48 
49 
50 
51 
52 
53 


54 


55 
56 
57 
58 
59 
60 
61 
62 


63 
64 
65 
66 
67 
68 
69 
70 
71 
72 
73 
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@Override 
public View getView (int position, View convertView, ViewGroup parent) { 
ViewHolder holder; 
if (convertView==null) { 
convertView=mInflater.inflate (R.layout.data_row, null); 
holder=new ViewHolder (); 
holder.textRow01= (TextView) convertView. findViewById (R. id. data_row_ 
01); 
holder.textRow02= (TextView) convertView. findViewById (R. іа. даса row __ 
02); 
convertView.setTag (holder); 
) 
else( 


holder- (ViewHolder)convertView.getTag|(); 


if(smsList!-null)( 
String row01Msg= " ("+ positione ") "+" 发 送 者 :"+ smsList [position] . Sender 
*","tsmsList[position].ReceiveTime; 
holder.textRow0l.setText (row01Msg); 
holder.textRow02.setText (smsList [position].ReturnResult); 
) 


return convertView; 


private class ViewHolder( 
TextView textRow0l; 
TextView textRow02; 


) 


继承 BaseAdapter 类 要 重 载 4 个 函数 ,包括 getCount O ‚денет O , getItemId ) 和 
getViewO , LayoutInflater 是 将 XML 文件 中 的 布局 映射 为 View 对 象 的 类 ,在 代码 第 
14 行进 行 了 声明 ,在 代码 第 51 行 , 将 data. row. xml 文件 映射 为 View 对 象 。 代 码 第 
70 行 和 第 71 行 的 内 容 , 需 要 对 应 data_row. xml 文件 中 的 界面 元 素 。 


3. SetupActivity 


SetupActivity 主要 用 来 保存 和 恢复 用 户 设置 的 运行 参数 ,第 一 次 启动 或 恢复 默认 设 
置 (在 选项 菜单 中 ) 后 ,界面 上 会 显示 系统 的 默认 设置 ,包括 城市 名 称 、 更 新 频率 、 是 否 提 
供 短信 和 服务、 是否 记录 短信 服务 数据 信息 和 短信 服务 的 关键 字 。SetupActivity 用 户 界面 
如 图 12.6 所 示 。 


310 Vroad z &| 41 3 # Z (* зА) 


WeatherDemo 


天 气 预报 


101050101 


应 用 系统 设置 取消 系统 设置 


а о 


12.6 SetupActivity 用 户 界 面 


SetupActivity. java 文件 中 ,主要 功能 集中 在 RestoreDefaultSetup() UpdateUIO #1 
SaveConfig() 三 个 函数 上 。RestoreDefaultSetup() 用 来 恢复 系统 的 默认 配置 ; UpdateUI() 
会 根据 保存 在 Config 类 中 的 数据 更 新 SetupActivity 的 界面 控件 ,SaveConfig() 根 据 界 面 
配置 更 改 Config 类 百 调 用 数据 库 适 配器 的 DBAdapter. SaveConfig() 函 数 , 将 Config 
类 中 的 配置 数据 写 和 数据库。 


1 private void RestoreDefaultSetup () ( 


2 Config.LoadDefaultConfig|(); 

3 UpdateUI (); 

4 dbAdapter.SaveConfig(); 

5 ] 

6 

7 private void UpdateUI () { 

8 cityNameView.setText (Config.CityName); 

5 refreshSpeedView.setText (Config.RefreshSpeed); 

10 smsServiceView.setChecked (Config.ProvideSmsService.equals ("true")? true:false); 
11 saveSmsInfoView.setChecked (Config.SaveSmsInfo.equals ("true")? true:false); 
AR keyWorkView.setText (Config.KeyWord); 

їз } 

14 


15 private void SaveConfig () ( 
16 Config.CityName- cityNameView.getText () .toString() .trim(); 
17 Config.RefreshSpeed- refreshSpeedView.getText () .toString(); 


18 if (smsServiceView.isChecked|())( 
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19 Config.ProvideSmsService= "true"; 
20 else( 

21 Config.ProvideSmsService= "false"; 
22 

23 if (saveSmsInfoView.isChecked ()) ( 

24 Config.SaveSmsInfo- "true"; 

25 

26 else( 

27 Config.SaveSmsInfo= "false"; 

28 

29 Config.KeyWord- keyWorkView.getText ().toString().trim(); 
30 dbAdapter.SaveConfig(); 

31 } 


最 后 ,为 了 所 有 定义 的 Activity 和 ListActivity 生效 ,在 AndroidManifest. xml 文件 
中 注册 所 有 定义 的 组 件 。 
«activity android:name- ".WeatherDemo" 


android:label- "@ string/app name" 


«intent- filter» 


«action android:name- "android.intent.action.MAIN" /> 


« /intent- filter» 
< /activity» 


1 
2 
3 
4 
5 «category android:name- "android.intent.category.LAUNCHER" /» 
6 
7 
8 «activity android:name- ".WeatherActivity"/» 

9 


«activity android:name- ".HistoryActivity"/» 


10 «activity android:name- ".SetupActivity"/» 
= zm 


综合 示例 使 用 的 是 TabHost 和 TabActivity 实现 的 Tab 导航 栏 ,尝试 使 用 操作 栏 和 
Fragment 实现 综合 实例 。 


附录 A 


Android 虚拟 设备 


Android 虚拟 设备 (AVD) 能 够 通过 Android 命令 行 工具 进行 管理 ,包括 AVD 的 创 
建 .删除 、. 移 动 和 更 新 等 。 表 A.1 给 出 了 AVD 的 管理 命令 及 其 参数 说 明 。 


表 A.1 AVD 管理 命令 


б < ә # 说 明 айа i 
android list 生成 一 个 系统 映像 的 target 
targets 清单 
android fist 显示 所 有 已 知 的 AVD, 内 容 
шш: T 包括 AVD 的 名 称 、 路 径 和 
li 外 观 等 
-n <name> AVD 名 称 建立 AVD 的 必 备 参数 
ч 使 用 android list targets 命令 获 
-t <targetID> Android 系统 映像 ID 取 Android 系统 映像 的 ID 列表 
-c <path> 或 SD 卡 映像 文件 路 径 或 示例 1: -c path/to/sdcard 
-c size [KI M] SD 卡 映像 的 容量 示例 2: -c 1000M 
如 果 新 建立 AVD 与 已 有 AVD 
的 名 称 相同 , 则 Android 工具 将 
curs 提示 *AVD 已 经 存在 ", 自 动 停止 
Í mek AVD AVD 的 创建 过 程 。 使 用 该 参数 ， 
android Android 工具 将 自动 删除 已 有 同 
create avd 名 AVD, 并 建立 新 的 AVD 
panis E AVD 文件 和 目录 的 
-s <name> 或 指定 AVD 的 外 观 , 利 用 外 | 示例 1: -s HVGA-L 


-s- width — height» 


观 名 称 或 长 宽 进行 选择 


示例 2: -s 320X240 


在 AVD 中 放置 一 个 快照 


-a- snapshot2> 文件 
默认 是 自动 选择 ABI, 如 果 
-Ь< аы > 平台 只 有 一 个 ABI 系统 


映像 


nad Android 虚拟 设备 
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续 表 
@ < £ 说 Ж 备 d 
"odi -n <name> AVD 名 称 删除 AVD 的 必 备 参数 
delete avd 
-п <name> AVD 名 称 移动 AVD 的 必 备 参数 
android -p <path> 移动 后 的 AVD 位 置 
move avd 
-r <rname> AVD 的 新 名 称 
修改 Android 虚拟 设备 ,使 
-update avd 其 与 文件 夹 下 的 新 SDK 
匹配 
修改 Android 工程 (必须 已 
-update project 经 有 一 个 AndroidManifest 
. xml 文件 ) 
android 为 一 个 测试 包 修改 Android 


update avds 


-update test-project 


工程 (必须 已 经 有 一 个 
AndroidManifest. xml 文件 ) 


-update lib-project 


修改 Android 库 工程 
(必须 已 经 有 一 
AndroidManifest. xml 文件 ) 


4r 


-update adb 


修改 adb 来 支持 USB 设备 


-update sdk 


修改 sdk 


emulator 


运行 新 创建 的 AVD 


示例 : emulator -avd WVGA800 
-scale 96dpi -dpi-device 160 


使 用 标准 的 Android 系统 映像 创建 AVD 时 ,Android 工具 允许 用 户 选 择 虚拟 设备 
所 支持 的 硬件 列表 , 表 A. 2 列举 出 可 以 选择 的 硬件 及 其 默认 值 。 同 时 ,用 户 也 可 以 在 
AVD 的 config. ini 文件 中 找到 相关 的 硬件 选择 设置 。 


表 A.2 虚拟 设备 硬件 列表 


特 征 描 述 属 性 
RAM 设备 容量 и FETU hw. ramSize 
触摸 屏 设备 是 否 支持 触摸 屏 ,默认 支持 hw. touchScreen 
轨迹 球 设备 是 否 支持 轨迹 球 ,默认 支持 hw. trackBall 
QWERTY 键盘 а ed keyboard 

认 支 持 

DPad 键 设备 是 否 支持 DPad 键 ,默认 支持 “| hw. dPad 
GSM 调制 解 调 器 кө жы емиш, hw. gsmModem 
摄像 头 设备 是 否 支持 摄像 头 ,默认 不 支持 “| hw. camera 
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续 表 
特 征 描 述 属 性 

Il 头 水 平方 向 像素 的 最 默认 值 为 640 hw. camera. maxHorizontalPixels 
¿a SOEUR 默认 值 为 480 hw. camera. maxVerticalPixels 
GPS 设备 是 否 支 持 GPS, 默 认 支 持 hw. gps 
电池 设备 是 否 支 持 电 池 ,默认 支持 hw. battery 
加 速度 计 маа ыа Кел hw. accelerometer 

支持 
录音 设备 是 否 支 录音 ,默认 支持 hw. audioInput 
声音 回放 设备 是 否 支 持 声 音 回放 ,默认 支持 | hw. audioOutput 
SD 卡 设备 是 否 支持 虚拟 的 SD 卡 , 默 认 hw. sdCard 

支持 
缓存 分 区 р ss e s disk. cachePartition 
缓存 分 区 容量 默认 值 为 66MB disk. cachePartition. size 
LCD 密度 设置 AVD 屏幕 使 用 的 密度 ,默认 hw. lcd. density 


值 是 *160” 


轨迹 球 


是 否 有 轨迹 球 


hw. trackBall 


附录 В 


Android API 


Android API 如 表 B. 1 所 示 。 


Ж B.1 Android АРІ 


包 名 称 说 明 

android 包含 了 标准 Android 应 用 使 用 的 资源 类 
当 AccessibilityEvent 事件 被 启动 后 ,后 台 运 行 的 AccessibilityService 
android. accessibilityservice | 会 接收 回调 函数 ,这 些 事件 指 的 是 在 用 户 接口 间 的 状态 转换 ,比如 焦 


点 变化 ,按钮 被 点 击 等 


android. accounts 直接 通过 统计 管理 器 访问 管理 的 统计 
android. animation 提供 视图 切换 时 显示 动画 效果 的 类 
android. app 封装 了 全 部 Android 应 用 模型 的 高 级 类 
android. app. admin 提供 系统 级 的 设备 管理 功能 ,允许 创建 企业 级 安全 的 应 用 
android. app. backup 包含 可 以 对 应 用 进行 备份 和 恢复 的 功能 
Android 允许 应 用 程序 发 布 嵌入 其 他 应 用 程序 中 的 视图 。 这 些 视图 被 
android. appwidget 称 为 窗口 部 件 . 由 AppWidget providers 发 布 。 可 以 包含 窗口 部 件 的 部 
件 被 称 为 AppWidget host 
А 管理 蓝牙 功能 的 类 ,例如 扫描 设备 ,连接 设备 ,管理 两 个 设备 间 数 据 
android. bluetooth 传输 
包含 了 用 来 在 设备 上 访问 和 发 布 数据 的 类 , 它 包 含 三 个 主要 类 别 
android. content 
的 API 
š 包含 了 用 来 访问 应 用 程序 软件 包 信 息 的 类 ,其 中 包括 它 的 行为 ,权限 、 
android. content. pm 


服务 .签名 和 供应 商 等 信息 


android. 


content. res 


包含 了 用 来 访问 应 用 程序 资源 的 类 ,比如 原始 的 有 价值 的 文件 ,颜色 、 
可 绘 区 ,多 媒体 或 者 包 中 的 其 他 文件 ,还 有 影响 应 用 程序 如 何 表现 的 
重要 的 设备 配置 信息 (如 位 置 、. 输 入 类 型 等 ) 


android. database 包含 用 来 探究 通过 内 容 提 供 商 返回 的 数据 的 类 

. е 包含 了 SQLite 数据 库 管理 类 ,应 用 程序 可 以 用 它 来 管理 自己 的 私有 数 
android. database. sqlite 据 库 
android. drm 提供 管理 DRM 内 容 和 确定 DRM 插件 (代理 ) 的 功能 的 类 
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续 表 
包 名 称 说 明 
android. gesture 提供 用 于 手势 识别 功能 的 类 
android ктары 提供 了 低级 别 的 图 形 工具 ,比如 画布 .颜色 过 滤器 ,点 和 和 矩形 ,可 以 对 屏 
幕 绘图 进行 直接 控制 
android. graphics. drawable | 提供 了 管理 只 用 来 显示 的 多 种 视觉 元 素 的 类 ,比如 位 图 和 和 斜率 
шт graphics. drawable. | 包含 了 用 米 绘制 几 何 图 形 的 类 
android. hardware 提供 对 可 能 并 不 是 每 台 Android 设备 都 具有 的 硬件 设备 的 支持 
android. hardware. usb 提供 对 硬件 设备 中 USB 设备 支持 的 类 
android. inputmethodservice | 写 人 方法 的 基础 类 
android. location 定义 了 Android 基于 位 置 的 和 相关 服务 的 类 
android. media 提供 了 管理 语音 和 视频 中 的 多 种 媒体 接口 的 类 
android. media. audiofx 提供 了 管理 音频 效果 的 类 


android. 


media. effect 


管理 多 媒体 效果 的 类 


提供 支持 与 直接 连接 的 相机 等 设备 进行 交互 的 API, 使 用 MTP( 媒 体 


android. mtp 传输 协议 ) 中 的 子 集 PTP( 图 片 传输 协议 ) , 当 设 备 连接 .删除 .管理 、 存 
储 、 传 输 文件 和 元 数据 时 候 , 应 用 程序 可 接收 到 通知 
android. net 协助 进行 网 络 存 取 的 类 ,包括 标准 java. net. * 应 用 程序 接口 
android. net. http 支持 Http 协议 的 类 
为 RTP( 实 时 传输 协议 ) 提 供 的 API, 人 允许 应 用 程序 管理 点 播 或 交互 式 
android. net. rtp 数据 流 。 提 供 VoIP 通话、 会议 .音频 流 的 程序 ,可 以 使 用 这 些 API 来 
启动 会 话 ,传输 或 接收 任何 可 用 的 网 络 数据 流 
android. net. sip 提供 访问 会 话 发 起 协议 (SIP) 的 功能 ,如 使 用 SIP 来 接听 VoIP 电话 
android. net. wifi 提供 管理 设备 上 WiFi 功能 的 类 
android. net. wifi. p2p 提供 管理 设备 上 WiFi 的 点 对 点 功能 的 类 
mm 提供 访问 近 场 通信 (NFC) 功 能 ,允许 应 用 程序 在 МЕС 标签 中 读 取 
android. nfc NDEF 消息 
йй accedi 这 些 类 提供 对 不 同类 型 标签 技术 特征 进行 访问 的 类 ,一 个 标签 可 以 同 
android. nfc. tec 时 支持 多 种 技术 
android. opengl 提供 OpenGL 功能 
android. os 提供 设备 上 的 基本 操作 系统 服务 ,消息 路 由 和 进程 间 通 信 
android. os. storage 提供 设备 上 的 基本 操作 系统 的 存储 服务 
android. preference 提供 管理 应 用 程序 性 能 和 执行 UI 参 数 选择 的 类 
android. provider 提供 方便 的 类 用 来 访问 Android 提供 的 内 容 提供 商 
提供 一 个 底层 ,高 性 能 的 3D 运行 时 框架 ,该 框架 提供 构造 3D 场景 的 
android. renderscript 


API 函数 


nao Android API 
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续 表 
包 名 称 йош 
MEE 使 写 入 高 效 和 重 棒 的 SAX 操作 变 得 简单 的 框架 
android. security 提供 安全 功能 的 类 
android. service, textservice | 拼写 检查 器 服务 的 基础 类 
android. service. wallpaper 提供 墙纸 功能 的 类 
et 提供 扩展 语音 识别 服务 的 基础 类 
caneol beecl ds 提供 将 文本 转 成 不 同 语言 音频 输出 的 类 
| 提供 应 用 程序 接口 用 来 监测 基本 电话 信息 ,比如 网 络 类 型 和 连接 状 
езара 态 , 还 有 控制 电话 号 码 的 功能 
android, telephony. cdma ”| 提供 应 用 程序 接口 用 来 使 用 CDMA 特有 的 电话 性 能 


提供 应 用 程序 接口 用 来 使 用 GSM 特有 的 电话 性 能 ,比如 文本 /数据 / 


android. telephony. gsm PDUSNS ш. 

android. test 用 来 书写 Android 测试 实例 的 框架 

android. test. mock 提供 存根 或 者 多 种 Android 框架 基础 模拟 的 功能 类 

android. test. suitebuilder 支持 测试 运行 类 的 功能 类 

android. text 提供 用 来 显示 或 追踪 屏幕 上 文本 和 文本 间距 的 类 

android. text. format 提供 文本 内 容 格式 化 功能 的 类 

android. text. method 提供 用 来 监测 或 修改 键盘 输入 的 类 

android. text. style 提供 用 来 显示 或 改变 视图 实体 中 文本 间距 风格 的 类 

aqhana ий r 击 的 链接 并 创建 RFC 822 消息 类 型 (SMTP) 
"T 提供 一 般 的 功能 方法 ,比如 日 期 /时 间 控 制 .64 位 编 解码 器 、 字 符 串 和 

emet 数字 转换 方法 以 及 XML 功能 等 

android. view 提供 用 来 显示 控制 屏幕 布局 和 用 户 交 互 的 基本 用 户 接口 类 

android. view. accessibility 用 来 呈现 屏幕 内 容 和 变化 的 类 ,可 以 查询 系统 的 全 局 可 访问 状态 

android. view. animation 实现 中 间 帧 动画 的 类 

android. view. inputmethod | 用 来 进行 视图 和 输入 方法 (比如 软 键盘 ) 交 互 的 框架 类 

android. view. textservice 文本 服务 的 类 

android. webkit 提供 浏览 互联 网 的 工具 

android. widget 窗口 部 件 包 包含 应 用 程序 屏幕 上 使 用 的 UI 元 素 

dalvik. bytecode 提供 围绕 Dalvik 字 节 码 的 类 


dalvik. system 


提供 Dalvik VM 特有 的 功能 和 系统 信息 的 类 


附录 C 


£ 
ADB 命令 
常用 的 ADB 命令 如 表 C. 1 所 示 。 
表 C.1 ADB 命令 
类 ж 命 © 说 明 
dd 指定 adb 命令 发 往 连 接 的 USB 设备 (备注 : 如 果 连 接 
两 个 或 两 个 以 上 的 USB 设备 , 则 返回 错误 提示 ) 
指定 adb 命令 仅 发 往 运行 的 Android 模拟 器 (备注 : 
参数 -e 如 果 有 两 个 或 两 个 以 上 的 Android 模拟 器 在 运行 , 则 
返回 错误 提示 ) 
Sual bas 指定 adb 命名 链接 的 模拟 器 或 设备 ,模拟 器 或 设备 通 
um 过 “emulator- 端 口 ” 的 方式 指定 ,例如 emulator-5556 
devices 显示 所 有 链接 的 模拟 器 或 设备 列表 
通用 命令 help 显示 adb 支持 的 命令 列表 
version 显示 adb 的 版 本 号 
logcat[ —option> ] š Р 
[一 filter-specs 二 ] 打印 日 志 数 据 到 屏幕 
ini Efl d sys.d s 1 z LH 
调试 命令 Баерн е ys.dumpstate 和 logcat 数据 到 屏幕 ,用 以 
jdwp 显示 指定 设备 的 JDWP 进程 列表 
install —path-to-apk> 将 Android 应 用 程序 安装 到 模拟 器 或 设备 
数据 命令 pull <remote> <local> 将 模拟 器 或 设备 上 的 指定 文件 复制 到 开发 主机 
push 一 local> —remote> 将 开发 主机 上 的 指定 文件 复制 到 模拟 器 或 设备 
forward 一 local> —remote> ien ica 链接 的 数据 转发 到 指定 的 远程 
网 络 与 端口 == 
命令 在 USB 上 运行 PPP. <tty> 是 操作 PPP 流 的 命令 ， 


ppp <tty> [parm]… 


示例 : dev:/dev/omap csmi ttyl. [рагт]% 0 个 或 更 
多 PPP/PPPD 选项 ,比如 默认 路 由 ,本 地 ,notty 等 
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类 E f * 说 RB 
get-serialno 显示 adb 链接 的 模拟 器 或 设备 的 序列 号 
脚本 命令 get-state 显示 adb 链接 的 模拟 器 或 设备 的 状态 
wait-for-device 阻止 程序 运行 ,等 待 设备 就 绪 
start-server 检查 adb 服务 进程 是 否 运行 ,如 果 未 启动 则 启动 之 
服务 器 命令 
kill-server 终止 adb 服务 进程 
shell 针对 目标 模拟 器 或 设备 启动 一 个 远程 Shell 
Shell 命令 


shell [ — shellCommand> ] 


针对 目标 模拟 器 或 设备 启动 一 个 Shell, 并 直接 执行 
Shell йй 4 — shellCommand-- 


附录 D 人 
AndroidManifest 文件 


每 个 Android 应 用 程序 都 有 一 个 AndroidManifest. xml 文件 ,用 以 在 程序 运行 前 向 
Android 系统 声明 程序 的 相关 信息 。 这 些 信 息 包括 应 用 程序 的 命名 空间 、 模 块 组 成 、 宿 主 
进程 .许可 最低 SDK 版 本 程序 运行 所 需要 连接 的 函数 库 等 。 

AndroidManifest. xml 文件 主要 由 元 素 、 属 性 和 类 声明 等 重要 部 分 组 成 。 在 
AndroidManifest. xml 中 ,多 数 元 素 的 出 现 次 数 没有 限制 ,而 且 在 同一 层次 的 元 素 没有 顺 
FZOR, ffi] lll < activity >, < provider > fl < service > 26 3€ nf LA (Е fap Ji Л НЕ 9 . 但 
— manifest fll — application Jt € H fiE£fE AndroidManifest. xml 中 出 现 一 次 ,而 且 必 须 
出 现 一 次 。 

AndroidManifest. xml 文件 的 元 素 与 属性 关系 参考 表 D. 1 ,通用 结构 如 下 所 示 。 


1 <?xml version- "1.0" encoding- "utf- 8"?» 
2 

3 «manifest» 

4 «uses- permission /> 

5 <permission /> 

6 <permission- tree /> 

T <permission- group /> 

8 «instrumentation /> 

9 «uses- sdk /» 

10 «uses- configuration /» 
11 «uses- feature /> 

12 < supports- screens /> 

13 < compatible- screens /> 
14 «supports-gl- texture /> 
15 

16 «application» 

zT 

18 «activity» 

19 «intent- filter» 
20 «action /» 
21. < category /> 


22 <data /> 
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23 < /intent- filter» 

24 <meta- data /> 

25 < /activity» 

26 

27 <activity-alias> 

28 < intent- filter» ... < /intent- filter» 
29 <meta- data /> 

30 < /activity-alias» 

3l 

32 «service» 

33 < intent- filter» ... < /intent- filter» 
34 «meta- data/» 

35 « /service» 

36 

37 «receiver» 

38 < intent- filter» ... < /intent- filter» 
39 «meta- data /» 

40 < /receiver» 

41 

42 <provider> 

43 <grant- uri- permission /> 

44 <meta- data /> 

45 < /provider> 

46 

47 <uses- library /> 

48 

49 < /application» 

50 


51 </manifest> 


在 通常 情况 下 ,元 素 的 属性 是 用 来 描述 如 何 解 释 元 素 内 容 , 一 般 都 是 可 以 省 略 的 。 
但 在 AndroidManifest. xml 中 ,为 了 使 元 素 具 有 意义 ,一 些 特 定 的 属性 是 不 能 够 省 略 的 ， 
ff] ll — manifest 26 X If < xmlIns:android— JE PERI package 二 属性 。 如 果 需 要 为 同一 
个 元 素 的 属性 指定 多 个 值 , 则 需要 重复 书写 这 个 元 素 ,书写 方法 如 下 所 示 : 

«intent- filter ...> 


«action android:name- "android.intent.action.EDIT" /> 


«action android:name- "android.intent.action.INSERT" /> 


1 
2 
3 
4 «action android:name- "android.intent.action.DELETE" /> 
5 
6 


< /intent- filter» 


F£ 6 BJ E X Ж pa BH Ж 2, , I| I < activity >, < service > M< receiver > 5 JÚ 
素 。 如 果 在 直接 通过 android: name 属性 声明 类 名 , 则 声明 的 类 名 必须 包含 完成 的 包 名 
称 。 但 如 果 在 二 manifest 二 元 素 中 使 用 了 二 package 二 属性 , 则 可 以 在 android: name 属 
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性 声明 类 名 时 不 包含 完整 的 包 名 称 。 其 区 别 可 以 参考 下 面 的 两 段 代码 。 
完整 类 名 : 


<manifest ...> 


<application ...> 


«service android:name= "edu.hrbeu.ServiceDemo.MyService" ... 


ЕВ 

2 

3 

4 

5 < /service» 
6 

了 < /application> 
8 


< /manifest> 
简化 类 名 : 


£ <manifest package= "edu.hrbeu.ServiceDemo " ... > 
z <application ...> 

3 < service android:name= ".MyService" ... > 
4 

5 < /service> 

6 

学 « /application» 

8 


< /manifest» 
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